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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Public parse job id (e.g. parse_Kg) returned by POST /api/v3/parse with options.async=true. Malformed or unknown tokens return 404.
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.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Live progress while a polled async job is in flight.
Show child attributes
Show child attributes
Failure details surfaced on terminal-failed async parse jobs.
Show child attributes
Show child attributes