curl --request GET \
--url https://paradigm.lighton.ai/api/v3/parse/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://paradigm.lighton.ai/api/v3/parse/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://paradigm.lighton.ai/api/v3/parse/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "parse_Kg",
"status": "pending",
"created_at": "2026-03-31T10:00:00+00:00",
"completed_at": null,
"processing_time_ms": null,
"document": {
"filename": "report.pdf",
"page_count": null,
"file_size_bytes": 245120,
"mime_type": "application/pdf"
},
"result": null,
"usage": null,
"progress": null,
"error": null
}Get the status and result of an async parse job
Poll for the status and result of an async parse job submitted via POST /api/v3/parse with options.async=true. Returns the same envelope shape as the synchronous parse endpoint once status is completed.
curl https://api.lighton.ai/api/v3/parse/parse_Kg \
-H 'Authorization: Bearer $TOKEN'
Recommended polling cadence: 1s for the first 10s, then 5s, capped at 30s. Stop polling once status is in {completed, failed}.
curl --request GET \
--url https://paradigm.lighton.ai/api/v3/parse/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://paradigm.lighton.ai/api/v3/parse/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://paradigm.lighton.ai/api/v3/parse/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "parse_Kg",
"status": "pending",
"created_at": "2026-03-31T10:00:00+00:00",
"completed_at": null,
"processing_time_ms": null,
"document": {
"filename": "report.pdf",
"page_count": null,
"file_size_bytes": 245120,
"mime_type": "application/pdf"
},
"result": null,
"usage": null,
"progress": null,
"error": null
}Authorizations
Path Parameters
Response
Async parse job status and (once terminal) result. status is pending/processing while in flight, completed on success, failed on failure. The result and usage blocks are populated only on success; the error block is populated only on failure.
Returned by GET /api/v3/parse/<id> — async parse job status + (once terminal) result.
Same shape as the sync ParseResponseSerializer but with completion fields
(result, usage, completed_at, processing_time_ms,
document.page_count) allowed to be null while the job is still in flight,
plus an error block populated only on terminal failure.