Skip to main content
GET
/
api
/
v2
/
chat
/
document-analysis
/
{uuid}
Retrieve a document analysis status or results
curl --request GET \
  --url https://paradigm.lighton.ai/api/v2/chat/document-analysis/{uuid} \
  --header 'Authorization: Bearer <token>'
{
  "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "INITIALIZING",
  "result": "<string>",
  "progress": 123,
  "reduction_phase": 123,
  "documents": [
    123
  ],
  "chat_response_answer": "<string>",
  "running_state": {
    "workflow_id": "<string>",
    "status": "<string>",
    "total_input_len": 123,
    "total_input_token": 123,
    "total_output_len": 123,
    "total_output_token": 123,
    "total_steps": 123,
    "completed_steps": 123,
    "failed_steps": 123,
    "seconds_since_start": 123,
    "retry_step": {
      "step_key": "<string>",
      "step_type": "<string>",
      "seconds_since_started": 123,
      "input_len": 123,
      "input_token": 123,
      "output_len": 123,
      "output_token": 123,
      "retry_count": 0
    },
    "running_step": {
      "step_key": "<string>",
      "step_type": "<string>",
      "seconds_since_started": 123,
      "input_len": 123,
      "input_token": 123,
      "output_len": 123,
      "output_token": 123,
      "retry_count": 0
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

uuid
string
required

Response

Response serializer for document analysis results.

uuid
string<uuid>
required

UUID of the document analysis task

status
enum<string>
required

Current status of the analysis task

  • INITIALIZING - Initialisation
  • PROMPT_GENERATION_INITIALIZING - Initialisation de la génération de prompt
  • PROMPT_GENERATED - Prompt Generated
  • VISUAL_SUMMARIZATION - Génération des résumés visuels intermédiaires
  • VISUAL_SUMMARIZATION_GENERATED - Résumés visuels intermédiaires générés
  • SUMMARIZATION_GENERATING_INTERMEDIATE_SUMMARIES - Génération des résumés intermédiaires
  • INTERMEDIATE_SUMMARIES_GENERATED - Résumés intermédiaires générés
  • GENERATING_FINAL_SUMMARY - Génération du résumé final
  • COMPLETED - Terminé
  • ERROR - Erreur
  • CANCELLED - Cancelled
Available options:
INITIALIZING,
PROMPT_GENERATION_INITIALIZING,
PROMPT_GENERATED,
VISUAL_SUMMARIZATION,
VISUAL_SUMMARIZATION_GENERATED,
SUMMARIZATION_GENERATING_INTERMEDIATE_SUMMARIES,
INTERMEDIATE_SUMMARIES_GENERATED,
GENERATING_FINAL_SUMMARY,
COMPLETED,
ERROR,
CANCELLED
result
string

Final analysis result text

progress
number<double>

Progress percentage (0-100)

reduction_phase
integer

Current reduction phase of the analysis task

documents
integer[] | null

List of document IDs used in the analysis

chat_response_answer
string

Answer from the chat response

running_state
object

Real-time workflow execution state with step details