Poll for the status and result of an async extract job submitted via POST /api/v3/extract with options.async=true. Returns the same envelope shape as the synchronous extract endpoint once status is completed.
Pagination: when completed, result.data is paginated with a fixed page size of 15. Use the page query param (1-based) to navigate; result.pagination reports total_items, total_pages, has_next, has_prev.
Recommended polling cadence: 1s for the first 10s, then 5s, capped at 30s. Stop polling once status is in {completed, failed}.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
job_id
string
required
Query Parameters
page
integer
default:1
1-based page index for navigating result.data. Fixed page size of 15 items. An out-of-range page is rejected.
Response
Extract job status (pending, processing, completed, or failed).
id
string
required
status
string
required
created_at
string<date-time> | null
completed_at
string<date-time> | null
processing_time_ms
integer | null
document
ExtractDocument · object | null
Show child attributes
result
ExtractResult · object | null
Show child attributes
usage
ExtractUsage · object | null
Show child attributes
progress
JobProgress · object | null
Live progress of a long-running async job while it is in flight.
Shared by the parse (GET /api/v3/parse/<id>) and extract
(GET /api/v3/extract/<id>) polling envelopes: pages_processed is the
count of pages done so far and percentage is the completion percentage
[0, 100] derived from it.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"LightOn Developers","colors":{"primary":"#1f99bb","light":"#1f99bb","dark":"#1f99bb"},"logo":{"light":"https://mintcdn.com/lighton-developers/dojq_qF_vSGGGm4-/logo/light.svg?fit=max\u0026auto=format\u0026n=dojq_qF_vSGGGm4-\u0026q=85\u0026s=345d3b10124f99971a7737a9f06f2886","dark":"https://mintcdn.com/lighton-developers/dojq_qF_vSGGGm4-/logo/dark.svg?fit=max\u0026auto=format\u0026n=dojq_qF_vSGGGm4-\u0026q=85\u0026s=d1c2d4800c07667359bb3abf2437e7aa"},"favicon":"https://mintcdn.com/lighton-developers/p54dDELPycbNT9ym/favicon.svg?fit=max\u0026auto=format\u0026n=p54dDELPycbNT9ym\u0026q=85\u0026s=c9a4897b47f6d0e0d035509f82d5c847","navbar":{"primary":{"type":"button","label":"Console","href":"https://console.lighton.ai"}},"footer":{"socials":{"x":"https://x.com/lightonio","linkedin":"https://www.linkedin.com/company/lighton","bluesky":"https://bsky.app/profile/lightonai.bsky.social","youtube":"https://www.youtube.com/@lighton4013","website":"https://lighton.ai/newsletter"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Playground","icon":"circle-play","href":"https://console.lighton.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lighton-developers","hasAudioNarration":false,"actualSubdomain":"lighton-developers","customDomains":["developers.lighton.ai"],"gitSource":{"type":"github","owner":"lightonai","repo":"lighton-developers-documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ae0d933663d8e17af01bd02","clientVersion":"0.0.4263","searchFilterCounts":[{"language":"default","tag":"API Reference","count":50},{"language":"default","tag":"Intelligence","count":30},{"language":"default","tag":"Tutorials","count":15},{"language":"default","tag":"Facets","count":14},{"language":"default","tag":"Administration","count":13},{"language":"default","tag":"MCP Server","count":9},{"language":"default","tag":"Integrations","count":8},{"language":"default","tag":"Classify and organise documents","count":8},{"language":"default","tag":"Workspaces","count":8},{"language":"default","tag":"Budget","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@lighton.ai"}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/extract/get-the-status-and-result-of-an-async-extract-job","slug":"/api-reference/extract/get-the-status-and-result-of-an-async-extract-job","pageMetadata":{"title":"Get the status and result of an async extract job","description":"Poll for the status and result of an async extract job submitted via `POST /api/v3/extract` with `options.async=true`. Returns the same envelope shape as the synchronous extract endpoint once `status` is `completed`.\n\n```bash\ncurl https://api.lighton.ai/api/v3/extract/ext_0196e4b2a3c14d5e \\\n -H 'Authorization: Bearer $TOKEN'\n```\n\n**Pagination:** when completed, `result.data` is paginated with a fixed page size of 15. Use the `page` query param (1-based) to navigate; `result.pagination` reports `total_items`, `total_pages`, `has_next`, `has_prev`.\n\n**Recommended polling cadence:** 1s for the first 10s, then 5s, capped at 30s. Stop polling once `status` is in `{completed, failed}`.","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/extract/{job_id}","href":"/api-reference/extract/get-the-status-and-result-of-an-async-extract-job","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n pre: \"pre\",\n span: \"span\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n }, {CodeBlock} = _components;\n if (!CodeBlock) _missingMdxReference(\"CodeBlock\", true);\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Poll for the status and result of an async extract job submitted via \", _jsx(_components.code, {\n children: \"POST /api/v3/extract\"\n }), \" with \", _jsx(_components.code, {\n children: \"options.async=true\"\n }), \". Returns the same envelope shape as the synchronous extract endpoint once \", _jsx(_components.code, {\n children: \"status\"\n }), \" is \", _jsx(_components.code, {\n children: \"completed\"\n }), \".\"]\n }), \"\\n\", _jsx(CodeBlock, {\n numberOfLines: \"2\",\n language: \"shellscript\",\n children: _jsx(_components.pre, {\n className: \"shiki shiki-themes github-light-default dark-plus\",\n style: {\n backgroundColor: \"#ffffff\",\n \"--shiki-dark-bg\": \"#0B0C0E\",\n color: \"#1f2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n language: \"shellscript\",\n children: _jsxs(_components.code, {\n language: \"shellscript\",\n numberOfLines: \"2\",\n children: [_jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#8250DF\",\n \"--shiki-dark\": \"#DCDCAA\"\n },\n children: \"curl\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \" https://api.lighton.ai/api/v3/extract/ext_0196e4b2a3c14d5e \\\\\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \" -H \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"'Authorization: Bearer $TOKEN'\"\n })]\n }), \"\\n\"]\n })\n })\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Pagination:\"\n }), \" when completed, \", _jsx(_components.code, {\n children: \"result.data\"\n }), \" is paginated with a fixed page size of 15. Use the \", _jsx(_components.code, {\n children: \"page\"\n }), \" query param (1-based) to navigate; \", _jsx(_components.code, {\n children: \"result.pagination\"\n }), \" reports \", _jsx(_components.code, {\n children: \"total_items\"\n }), \", \", _jsx(_components.code, {\n children: \"total_pages\"\n }), \", \", _jsx(_components.code, {\n children: \"has_next\"\n }), \", \", _jsx(_components.code, {\n children: \"has_prev\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Recommended polling cadence:\"\n }), \" 1s for the first 10s, then 5s, capped at 30s. Stop polling once \", _jsx(_components.code, {\n children: \"status\"\n }), \" is in \", _jsx(_components.code, {\n children: \"{completed, failed}\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get the status and result of an async extract job","description":"Poll for the status and result of an async extract job submitted via `POST /api/v3/extract` with `options.async=true`. Returns the same envelope shape as the synchronous extract endpoint once `status` is `completed`.\n\n```bash\ncurl https://api.lighton.ai/api/v3/extract/ext_0196e4b2a3c14d5e \\\n -H 'Authorization: Bearer $TOKEN'\n```\n\n**Pagination:** when completed, `result.data` is paginated with a fixed page size of 15. Use the `page` query param (1-based) to navigate; `result.pagination` reports `total_items`, `total_pages`, `has_next`, `has_prev`.\n\n**Recommended polling cadence:** 1s for the first 10s, then 5s, capped at 30s. Stop polling once `status` is in `{completed, failed}`.","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/extract/{job_id}","href":"/api-reference/extract/get-the-status-and-result-of-an-async-extract-job","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"api_v3_extract_retrieve","description":"Poll for the status and result of an async extract job submitted via `POST /api/v3/extract` with `options.async=true`. Returns the same envelope shape as the synchronous extract endpoint once `status` is `completed`.\n\n```bash\ncurl https://api.lighton.ai/api/v3/extract/ext_0196e4b2a3c14d5e \\\n -H 'Authorization: Bearer $TOKEN'\n```\n\n**Pagination:** when completed, `result.data` is paginated with a fixed page size of 15. Use the `page` query param (1-based) to navigate; `result.pagination` reports `total_items`, `total_pages`, `has_next`, `has_prev`.\n\n**Recommended polling cadence:** 1s for the first 10s, then 5s, capped at 30s. Stop polling once `status` is in `{completed, failed}`.","summary":"Get the status and result of an async extract job","parameters":["493455ca-c284-4391-bf4e-f8b2beb4e7ef","4d1e4af3-1228-493b-8f7c-aa7361796687"],"tags":["Extract"],"security":["dde757fa-f5ea-4645-b369-d13ed78de5c2"],"responses":{"200":"6da8c6ee-d3d7-49a1-ae76-f5b9e9c3ad76","401":"2082ca00-a343-46fd-a6b2-c9d3b77d07b6","404":"f112cd38-617d-4c2f-a7a0-1664d94e5a08","503":"cf73497f-7711-47b4-96f7-e4ab6387d64d"},"method":"get","type":"path","servers":["48c3fa0c-537e-4ab8-b62c-fc02ab11f431"],"path":"/api/v3/extract/{job_id}","baseUrlOptions":["https://api.lighton.ai"],"title":"Get the status and result of an async extract job","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"493455ca-c284-4391-bf4e-f8b2beb4e7ef":{"in":"path","name":"job_id","schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true},"4d1e4af3-1228-493b-8f7c-aa7361796687":{"in":"query","name":"page","schema":{"type":"integer","default":1,"description":"1-based page index for navigating `result.data`. Fixed page size of 15 items. An out-of-range page is rejected.","uniqueKey":"","typeLabel":"integer"},"description":"1-based page index for navigating `result.data`. Fixed page size of 15 items. An out-of-range page is rejected."}},"responses":{"6da8c6ee-d3d7-49a1-ae76-f5b9e9c3ad76":{"content":{"application/json":{"schema":{"properties":{"id":{"title":"Id","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"status":{"title":"Status","type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"created_at":{"oneOf":[{"type":"string","title":"Created At","format":"date-time","uniqueKey":"created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Created At","uniqueKey":"created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_at","typeLabel":"string\u003cdate-time> | null"},"completed_at":{"oneOf":[{"type":"string","title":"Completed At","format":"date-time","uniqueKey":"completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Completed At","uniqueKey":"completed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"completed_at","typeLabel":"string\u003cdate-time> | null"},"processing_time_ms":{"oneOf":[{"type":"integer","title":"Processing Time Ms","uniqueKey":"processing_time_ms.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Processing Time Ms","uniqueKey":"processing_time_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"processing_time_ms","typeLabel":"integer | null"},"document":{"oneOf":[{"type":"object","title":"ExtractDocument","properties":{"filename":{"oneOf":[{"type":"string","title":"Filename","uniqueKey":"document.oneOf.0.filename.oneOf.0","typeLabel":"string"},{"type":"null","title":"Filename","uniqueKey":"document.oneOf.0.filename.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.oneOf.0.filename","typeLabel":"string | null"},"page_count":{"oneOf":[{"type":"integer","title":"Page Count","uniqueKey":"document.oneOf.0.page_count.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Page Count","uniqueKey":"document.oneOf.0.page_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.oneOf.0.page_count","typeLabel":"integer | null"},"file_size_bytes":{"oneOf":[{"type":"integer","title":"File Size Bytes","uniqueKey":"document.oneOf.0.file_size_bytes.oneOf.0","typeLabel":"integer"},{"type":"null","title":"File Size Bytes","uniqueKey":"document.oneOf.0.file_size_bytes.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.oneOf.0.file_size_bytes","typeLabel":"integer | null"},"mime_type":{"oneOf":[{"type":"string","title":"Mime Type","uniqueKey":"document.oneOf.0.mime_type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Mime Type","uniqueKey":"document.oneOf.0.mime_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.oneOf.0.mime_type","typeLabel":"string | null"}},"uniqueKey":"document.oneOf.0","typeLabel":"ExtractDocument · object"},{"type":"null","uniqueKey":"document.oneOf.1","typeLabel":"null"}],"uniqueKey":"document","typeLabel":"ExtractDocument · object | null"},"result":{"oneOf":[{"type":"object","title":"ExtractResult","properties":{"data":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"result.oneOf.0.data.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Data","uniqueKey":"result.oneOf.0.data.oneOf.0","typeLabel":"Data · object[]"},{"type":"null","title":"Data","uniqueKey":"result.oneOf.0.data.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.oneOf.0.data","typeLabel":"Data · object[] | null"},"pagination":{"oneOf":[{"type":"object","title":"ExtractPagination","required":["page","page_size","total_items","total_pages","has_next","has_prev"],"properties":{"page":{"title":"Page","type":"integer","isRequired":true,"uniqueKey":"result.oneOf.0.pagination.oneOf.0.page","typeLabel":"integer"},"page_size":{"title":"Page Size","type":"integer","isRequired":true,"uniqueKey":"result.oneOf.0.pagination.oneOf.0.page_size","typeLabel":"integer"},"total_items":{"title":"Total Items","type":"integer","isRequired":true,"uniqueKey":"result.oneOf.0.pagination.oneOf.0.total_items","typeLabel":"integer"},"total_pages":{"title":"Total Pages","type":"integer","isRequired":true,"uniqueKey":"result.oneOf.0.pagination.oneOf.0.total_pages","typeLabel":"integer"},"has_next":{"title":"Has Next","type":"boolean","isRequired":true,"uniqueKey":"result.oneOf.0.pagination.oneOf.0.has_next","typeLabel":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean","isRequired":true,"uniqueKey":"result.oneOf.0.pagination.oneOf.0.has_prev","typeLabel":"boolean"}},"uniqueKey":"result.oneOf.0.pagination.oneOf.0","typeLabel":"ExtractPagination · object"},{"type":"null","uniqueKey":"result.oneOf.0.pagination.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.oneOf.0.pagination","typeLabel":"ExtractPagination · object | null"}},"uniqueKey":"result.oneOf.0","typeLabel":"ExtractResult · object"},{"type":"null","uniqueKey":"result.oneOf.1","typeLabel":"null"}],"uniqueKey":"result","typeLabel":"ExtractResult · object | null"},"usage":{"oneOf":[{"type":"object","title":"ExtractUsage","properties":{"pages_processed":{"oneOf":[{"type":"integer","title":"Pages Processed","uniqueKey":"usage.oneOf.0.pages_processed.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Pages Processed","uniqueKey":"usage.oneOf.0.pages_processed.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.oneOf.0.pages_processed","typeLabel":"integer | null"}},"uniqueKey":"usage.oneOf.0","typeLabel":"ExtractUsage · object"},{"type":"null","uniqueKey":"usage.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage","typeLabel":"ExtractUsage · object | null"},"progress":{"oneOf":[{"type":"object","title":"JobProgress","description":"Live progress of a long-running async job while it is in flight.\n\nShared by the parse (``GET /api/v3/parse/\u003cid>``) and extract\n(``GET /api/v3/extract/\u003cid>``) polling envelopes: ``pages_processed`` is the\ncount of pages done so far and ``percentage`` is the completion percentage\n[0, 100] derived from it.","required":["percentage","pages_processed"],"properties":{"percentage":{"title":"Percentage","type":"integer","isRequired":true,"uniqueKey":"progress.oneOf.0.percentage","typeLabel":"integer"},"pages_processed":{"title":"Pages Processed","type":"integer","isRequired":true,"uniqueKey":"progress.oneOf.0.pages_processed","typeLabel":"integer"}},"uniqueKey":"progress.oneOf.0","typeLabel":"JobProgress · object"},{"type":"null","uniqueKey":"progress.oneOf.1","typeLabel":"null"}],"uniqueKey":"progress","typeLabel":"JobProgress · object | null"}},"required":["id","status"],"title":"ExtractJobResponse","type":"object","uniqueKey":"","typeLabel":"ExtractJobResponse · object"},"examples":{"CompletedJob":{"title":"CompletedJob","summary":"Completed job","value":{"id":"ext_0196e4b2a3c14d5e8f7a9b2c1d0e3f4a","status":"completed","created_at":"2026-03-31T10:00:00+00:00","completed_at":"2026-03-31T10:00:04+00:00","processing_time_ms":3200,"document":{"filename":"invoice.pdf","page_count":3,"file_size_bytes":245120,"mime_type":"application/pdf"},"result":{"data":[{"invoice_number":"INV-2026-001","total":null},{"invoice_number":null,"total":1250},{"invoice_number":null,"total":null}],"pagination":{"page":1,"page_size":15,"total_items":3,"total_pages":1,"has_next":false,"has_prev":false}},"usage":{"pages_processed":3},"progress":{"percentage":100,"pages_processed":3}}},"ProcessingJob":{"title":"ProcessingJob","summary":"Processing job","description":"A worker is extracting page-by-page. `progress` is the completion percentage [0, 100] so clients can show a determinate progress bar. Keep polling.","value":{"id":"ext_0196e4b2a3c14d5e8f7a9b2c1d0e3f4d","status":"processing","created_at":"2026-03-31T10:00:00+00:00","completed_at":null,"processing_time_ms":null,"document":{"filename":"large-report.pdf","page_count":450,"file_size_bytes":5242880,"mime_type":"application/pdf"},"result":null,"usage":null,"progress":{"percentage":27,"pages_processed":120}}},"PendingJob":{"title":"PendingJob","summary":"Pending job","value":{"id":"ext_0196e4b2a3c14d5e8f7a9b2c1d0e3f4b","status":"pending","created_at":"2026-03-31T10:00:00+00:00","completed_at":null,"processing_time_ms":null,"document":{"filename":"large-report.pdf","page_count":null,"file_size_bytes":5242880,"mime_type":"application/pdf"},"result":null,"usage":null,"progress":null}},"FailedJob":{"title":"FailedJob","summary":"Failed job","value":{"id":"ext_0196e4b2a3c14d5e8f7a9b2c1d0e3f4c","status":"failed","created_at":"2026-03-31T10:00:00+00:00","completed_at":"2026-03-31T10:00:05+00:00","processing_time_ms":null,"document":{"filename":"corrupted.pdf","page_count":null,"file_size_bytes":102400,"mime_type":"application/pdf"},"result":null,"usage":null,"progress":null}}},"exampleType":"examples"}},"description":"Extract job status (pending, processing, completed, or failed).","exampleType":"examples"},"2082ca00-a343-46fd-a6b2-c9d3b77d07b6":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","description":"Job/resource id when one already exists (useful for async error diagnosis); null otherwise.","isRequired":true,"uniqueKey":"id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Job/resource id when one already exists (useful for async error diagnosis); null otherwise.","isRequired":true,"uniqueKey":"id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"id","typeLabel":"string | null"},"code":{"type":"integer","description":"HTTP status code","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"error":{"type":"string","description":"Error code used by the UI as a translation key","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable error message for developers","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"doc_url":{"type":"string","description":"Link to the error-code documentation page","isRequired":true,"uniqueKey":"doc_url","typeLabel":"string"}},"required":["code","detail","doc_url","error","id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Unauthorized":{"title":"Unauthorized","value":{"id":null,"code":401,"error":"unauthorized","detail":"Authentication credentials were not provided or are invalid.","doc_url":"https://developers.lighton.ai/errors#unauthorized"}}},"exampleType":"examples"}},"description":"Authentication credentials were not provided or are invalid","exampleType":"examples"},"f112cd38-617d-4c2f-a7a0-1664d94e5a08":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","description":"Job/resource id when one already exists (useful for async error diagnosis); null otherwise.","isRequired":true,"uniqueKey":"id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Job/resource id when one already exists (useful for async error diagnosis); null otherwise.","isRequired":true,"uniqueKey":"id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"id","typeLabel":"string | null"},"code":{"type":"integer","description":"HTTP status code","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"error":{"type":"string","description":"Error code used by the UI as a translation key","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable error message for developers","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"doc_url":{"type":"string","description":"Link to the error-code documentation page","isRequired":true,"uniqueKey":"doc_url","typeLabel":"string"}},"required":["code","detail","doc_url","error","id"],"uniqueKey":"","typeLabel":"object"},"examples":{"NotFound":{"title":"NotFound","summary":"Not Found","value":{"id":null,"code":404,"error":"not_found","detail":"The requested resource was not found.","doc_url":"https://developers.lighton.ai/errors#not_found"}}},"exampleType":"examples"}},"description":"The requested resource was not found","exampleType":"examples"},"cf73497f-7711-47b4-96f7-e4ab6387d64d":{"description":"API is under maintenance. Check `GET /api/v3/system/status` for active periods and retry.","content":{"application/json":{"schema":{"type":"object","description":"Returned by the maintenance middleware when the requested endpoint is blocked.","required":["detail","error","mode"],"properties":{"detail":{"type":"string","example":"System is under maintenance.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"type":"string","example":"service_maintenance","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"mode":{"type":"string","enum":["full_shutdown","warning_banner"],"description":"`full_shutdown` blocks all traffic; `warning_banner` also blocks and shows a dismissible toast.","isRequired":true,"uniqueKey":"mode","typeLabel":"enum\u003cstring>"},"reason":{"type":"string","description":"Operator-supplied maintenance reason, if any.","uniqueKey":"reason","typeLabel":"string"},"started_at":{"type":"string","format":"date-time","uniqueKey":"started_at","typeLabel":"string\u003cdate-time>"},"endpoint_category_names":{"type":"array","items":{"type":"string","uniqueKey":"endpoint_category_names.items.[INDEX]","typeLabel":"string"},"description":"Non-empty only for category-scoped periods. Empty means all endpoints are affected.","uniqueKey":"endpoint_category_names","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"System is under maintenance.","error":"service_maintenance","mode":"full_shutdown","reason":"\u003cstring>","started_at":"2023-11-07T05:31:56Z","endpoint_category_names":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"dde757fa-f5ea-4645-b369-d13ed78de5c2":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","scopes":[]}}},"servers":{"48c3fa0c-537e-4ab8-b62c-fc02ab11f431":{"url":"https://api.lighton.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/api-console.yaml"},"subdomain":"lighton-developers","siteName":"LightOn Developers","title":"Get the status and result of an async extract job - LightOn Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-16T07:50:03.052Z","originalFileLocation":"api-reference/extract/get-the-status-and-result-of-an-async-extract-job.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Poll for the status and result of an async extract job submitted via POST /api/v3/extract with options.async=true. Returns the same envelope shape as the synchronous extract endpoint once status is completed. bash curl https://api.lighton.ai/api/v3/extract/ext_0196e4b2a3c14d5e \\ -H \u0026#x27;Authorization: Bearer $TOKEN\u0026#x27; Pagination: when completed, result.data is paginated with a fixed page size of 15. Use the page query param (1-based) to navigate; result.pagination reports total_items, total_pages, has_next, has_prev. Recommended polling cadence: 1s for the first 10s, then 5s, capped at 30s. Stop polling once status is in {completed, failed}.\">\u003cmeta data-mint-head name=\"application-name\" content=\"LightOn Developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lighton-developers/2Zh9Mbvo5QQal47m/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/lighton-developers/2Zh9Mbvo5QQal47m/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lighton-developers/2Zh9Mbvo5QQal47m/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lighton-developers/2Zh9Mbvo5QQal47m/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lighton-developers/2Zh9Mbvo5QQal47m/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lighton-developers/2Zh9Mbvo5QQal47m/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lighton-developers/2Zh9Mbvo5QQal47m/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lighton-developers/2Zh9Mbvo5QQal47m/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lighton-developers/2Zh9Mbvo5QQal47m/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get the status and result of an async extract job - LightOn Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Poll for the status and result of an async extract job submitted via POST /api/v3/extract with options.async=true. Returns the same envelope shape as the synchronous extract endpoint once status is completed. bash curl https://api.lighton.ai/api/v3/extract/ext_0196e4b2a3c14d5e \\ -H \u0026#x27;Authorization: Bearer $TOKEN\u0026#x27; Pagination: when completed, result.data is paginated with a fixed page size of 15. Use the page query param (1-based) to navigate; result.pagination reports total_items, total_pages, has_next, has_prev. Recommended polling cadence: 1s for the first 10s, then 5s, capped at 30s. Stop polling once status is in {completed, failed}.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LightOn Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.lighton.ai/api-reference/extract/get-the-status-and-result-of-an-async-extract-job\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lighton-developers.mintlify.site/_mintlify/api/og/v2?division=Extract\u0026amp;title=Get+the+status+and+result+of+an+async+extract+job\u0026amp;description=Poll+for+the+status+and+result+of+an+async+extract+job+submitted+via+%60POST+%2Fapi%2Fv3%2Fextract%60+with+%60options.async%3Dtrue%60.+Returns+the+same+envelope+shape+as+the+sy\u0026amp;theme=42de0de5beb070a7d2770d17\u0026amp;signature=ec01d8672892da5cd138acfa74176a67a20dc4ff3c0b7ee8313c65d841087958\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get the status and result of an async extract job - LightOn Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Poll for the status and result of an async extract job submitted via POST /api/v3/extract with options.async=true. Returns the same envelope shape as the synchronous extract endpoint once status is completed. bash curl https://api.lighton.ai/api/v3/extract/ext_0196e4b2a3c14d5e \\ -H \u0026#x27;Authorization: Bearer $TOKEN\u0026#x27; Pagination: when completed, result.data is paginated with a fixed page size of 15. Use the page query param (1-based) to navigate; result.pagination reports total_items, total_pages, has_next, has_prev. Recommended polling cadence: 1s for the first 10s, then 5s, capped at 30s. Stop polling once status is in {completed, failed}.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lighton-developers.mintlify.site/_mintlify/api/og/v2?division=Extract\u0026amp;title=Get+the+status+and+result+of+an+async+extract+job\u0026amp;description=Poll+for+the+status+and+result+of+an+async+extract+job+submitted+via+%60POST+%2Fapi%2Fv3%2Fextract%60+with+%60options.async%3Dtrue%60.+Returns+the+same+envelope+shape+as+the+sy\u0026amp;theme=42de0de5beb070a7d2770d17\u0026amp;signature=ec01d8672892da5cd138acfa74176a67a20dc4ff3c0b7ee8313c65d841087958\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/lighton-developers/2Zh9Mbvo5QQal47m/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LightOn Developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1f99bb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.lighton.ai/api-reference/extract/get-the-status-and-result-of-an-async-extract-job\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/extract/get-the-status-and-result-of-an-async-extract-job.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.lighton.ai/#organization\",\"name\":\"LightOn Developers\",\"url\":\"https://developers.lighton.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/lighton-developers/dojq_qF_vSGGGm4-/logo/light.svg?fit=max\u0026auto=format\u0026n=dojq_qF_vSGGGm4-\u0026q=85\u0026s=345d3b10124f99971a7737a9f06f2886\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.lighton.ai#website\",\"name\":\"LightOn Developers\",\"url\":\"https://developers.lighton.ai\",\"publisher\":{\"@id\":\"https://developers.lighton.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.lighton.ai/api-reference/extract/get-the-status-and-result-of-an-async-extract-job#webpage\",\"url\":\"https://developers.lighton.ai/api-reference/extract/get-the-status-and-result-of-an-async-extract-job\",\"name\":\"Get the status and result of an async extract job\",\"description\":\"Poll for the status and result of an async extract job submitted via POST /api/v3/extract with options.async=true. Returns the same envelope shape as the synchronous extract endpoint once status is completed. bash curl https://api.lighton.ai/api/v3/extract/ext_0196e4b2a3c14d5e \\\\ -H 'Authorization: Bearer $TOKEN' Pagination: when completed, result.data is paginated with a fixed page size of 15. Use the page query param (1-based) to navigate; result.pagination reports total_items, total_pages, has_next, has_prev. Recommended polling cadence: 1s for the first 10s, then 5s, capped at 30s. Stop polling once status is in {completed, failed}.\",\"dateModified\":\"2026-09-16T07:50:03.052Z\",\"isPartOf\":{\"@id\":\"https://developers.lighton.ai#website\"},\"breadcrumb\":{\"@id\":\"https://developers.lighton.ai/api-reference/extract/get-the-status-and-result-of-an-async-extract-job#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.lighton.ai/api-reference/extract/get-the-status-and-result-of-an-async-extract-job#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Document Processing\",\"item\":\"https://developers.lighton.ai/api-reference/parse/parse-a-document-to-markdown\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Extract\",\"item\":\"https://developers.lighton.ai/api-reference/extract/extract-structured-data-from-a-document\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get the status and result of an async extract job\",\"item\":\"https://developers.lighton.ai/api-reference/extract/get-the-status-and-result-of-an-async-extract-job\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.lighton.ai/api-reference/extract/get-the-status-and-result-of-an-async-extract-job#apireference\",\"headline\":\"Get the status and result of an async extract job\",\"name\":\"Get the status and result of an async extract job\",\"description\":\"Poll for the status and result of an async extract job submitted via POST /api/v3/extract with options.async=true. Returns the same envelope shape as the synchronous extract endpoint once status is completed. bash curl https://api.lighton.ai/api/v3/extract/ext_0196e4b2a3c14d5e \\\\ -H 'Authorization: Bearer $TOKEN' Pagination: when completed, result.data is paginated with a fixed page size of 15. Use the page query param (1-based) to navigate; result.pagination reports total_items, total_pages, has_next, has_prev. Recommended polling cadence: 1s for the first 10s, then 5s, capped at 30s. Stop polling once status is in {completed, failed}.\",\"url\":\"https://developers.lighton.ai/api-reference/extract/get-the-status-and-result-of-an-async-extract-job\",\"mainEntityOfPage\":{\"@id\":\"https://developers.lighton.ai/api-reference/extract/get-the-status-and-result-of-an-async-extract-job#webpage\"},\"dateModified\":\"2026-09-16T07:50:03.052Z\",\"publisher\":{\"@id\":\"https://developers.lighton.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.lighton.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LightOn Developers\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"LightOn Developers\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/extract/get-the-status-and-result-of-an-async-extract-job.md","siteName":"LightOn Developers","nav":{"global":{"anchors":[{"anchor":"Playground","icon":"circle-play","href":"https://console.lighton.ai"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"},{"title":"API Errors","href":"/api-reference/v3-error-codes"}]},{"group":"Intelligence","pages":[{"title":"Ask a question over your documents","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/ask","href":"/api-reference/ask/ask-a-question-over-your-documents"},{"title":"Search document chunks","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/search","href":"/api-reference/search/search-document-chunks"},{"group":"Files","pages":[{"title":"List files accessible to the authenticated user","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/files","href":"/api-reference/files/list-files-accessible-to-the-authenticated-user"},{"title":"Upload a file","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/files","href":"/api-reference/files/upload-a-file"},{"title":"Delete multiple files in a single request","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/files/bulk-delete","href":"/api-reference/files/delete-multiple-files-in-a-single-request"},{"title":"Retrieve a single file by ID","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/files/{id}","href":"/api-reference/files/retrieve-a-single-file-by-id"},{"title":"Update file metadata or replace its file","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml patch /api/v3/files/{id}","href":"/api-reference/files/update-file-metadata-or-replace-its-file"},{"title":"Delete a file","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml delete /api/v3/files/{id}","href":"/api-reference/files/delete-a-file"},{"title":"Download a document file","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/files/{id}/download","href":"/api-reference/files/download-a-document-file"},{"title":"Get document thumbnail","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/files/{id}/thumbnail","href":"/api-reference/files/get-document-thumbnail"}]},{"group":"Facets","pages":[{"title":"List content types","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/content-types","href":"/api-reference/facets/list-content-types"},{"title":"Define content types and attributes","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/content-types","href":"/api-reference/facets/define-content-types-and-attributes"},{"title":"Batch define content types and attributes","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/content-types/batch","href":"/api-reference/facets/batch-define-content-types-and-attributes"},{"title":"Resolve search scope","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/content-types/scope","href":"/api-reference/facets/resolve-search-scope"},{"title":"List content type templates","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/content-types/templates","href":"/api-reference/facets/list-content-type-templates"},{"title":"Resolve search scope","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/content-types/scope","href":"/api-reference/facets/resolve-search-scope"},{"title":"List file classifications and attribute values","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/files/{file_id}/facets","href":"/api-reference/facets/list-file-classifications-and-attribute-values"},{"title":"Classify file and set attribute values","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/files/{file_id}/facets","href":"/api-reference/facets/classify-file-and-set-attribute-values"},{"title":"Batch classify and set attribute values","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/files/{file_id}/facets/batch","href":"/api-reference/facets/batch-classify-and-set-attribute-values"}]},{"group":"Tags","pages":[{"title":"List all tags for the authenticated user's company","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/tags","href":"/api-reference/tags/list-all-tags-for-the-authenticated-users-company"},{"title":"Create a new tag for the company","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/tags","href":"/api-reference/tags/create-a-new-tag-for-the-company"},{"title":"Delete a company tag","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml delete /api/v3/tags/{id}","href":"/api-reference/tags/delete-a-company-tag"},{"title":"Add tags to a file","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/files/{id}/tags","href":"/api-reference/files/add-tags-to-a-file"},{"title":"Remove a tag from a file","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml delete /api/v3/files/{id}/tags/{tag_id}","href":"/api-reference/files/remove-a-tag-from-a-file"}]},{"group":"Workspaces","pages":[{"title":"List workspaces","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/workspaces","href":"/api-reference/workspaces/list-workspaces"},{"title":"Create a workspace","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/workspaces","href":"/api-reference/workspaces/create-a-workspace"},{"title":"Retrieve a workspace","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/workspaces/{id}","href":"/api-reference/workspaces/retrieve-a-workspace"},{"title":"Update a workspace","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml patch /api/v3/workspaces/{id}","href":"/api-reference/workspaces/update-a-workspace"},{"title":"Delete a workspace","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml delete /api/v3/workspaces/{id}","href":"/api-reference/workspaces/delete-a-workspace"},{"title":"Browse datasource folders","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/workspaces/datasource/browse","href":"/api-reference/workspaces/browse-datasource-folders"},{"title":"Test datasource credentials","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/workspaces/datasource/test","href":"/api-reference/workspaces/test-datasource-credentials"}]}]},{"group":"Document Processing","pages":[{"group":"Parse","pages":[{"title":"Parse a document to Markdown","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/parse","href":"/api-reference/parse/parse-a-document-to-markdown"},{"title":"Get the status and result of an async parse job","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/parse/{id}","href":"/api-reference/parse/get-the-status-and-result-of-an-async-parse-job"},{"title":"Render a document as PDF","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/preview","href":"/api-reference/parse/render-a-document-as-pdf"}]},{"group":"Extract","pages":[{"title":"Extract structured data from a document","description":"Pull specific fields from a document into a typed schema.\n\nAccepts exactly one of: a **file upload** (multipart/form-data), a **document URL** (JSON body), or a **`file_id`** referencing an already-ingested document (from `POST /v3/files`), plus a **JSON Schema** (the `schema` field) describing what to extract.\n\n### Sync mode (default)\nBlocks until extraction completes and returns **200** with the full result.\n\n```bash\ncurl -X POST https://api.lighton.ai/api/v3/extract \\\n -H 'Authorization: Bearer $TOKEN' \\\n -F file=@invoice.pdf \\\n -F 'schema={\"type\":\"object\",\"properties\":{\"invoice_number\":{\"type\":\"string\"}}}'\n```\n\n### Async mode (`options.async = true`)\nReturns **202** immediately with an `ext_\u003ctoken>` job id. Poll `GET /api/v3/extract/{id}` with that same id until `status` is `completed` or `failed`.\n\n```bash\ncurl -X POST https://api.lighton.ai/api/v3/extract \\\n -H 'Authorization: Bearer $TOKEN' \\\n -H 'Content-Type: application/json' \\\n -d '{\"document\": \"https://example.com/report.pdf\", \"schema\": {\"type\": \"object\", \"properties\": {\"title\": {\"type\": \"string\"}}}, \"options\": {\"async\": true}}'\n```\n\nFor multipart uploads, pass `options` as a JSON-encoded form field: `-F 'options={\"async\":true}'`.\n\n**Supported file types:** `.pdf`, `.png`, `.jpg`, `.jpeg`, `.pptx`, `.ppt`, `.odp`, `.docx`, `.odt`, `.doc`, `.html`\n\n**Sync limits:** 20 MB file size, 15 pages.\n\n**Async limits:** 100 MB file size, 1000 pages.","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/extract","href":"/api-reference/extract/extract-structured-data-from-a-document"},{"title":"Get the status and result of an async extract job","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/extract/{job_id}","href":"/api-reference/extract/get-the-status-and-result-of-an-async-extract-job"}]}]},{"group":"Administration","pages":[{"group":"API Keys","pages":[{"title":"List API keys","description":"List all API keys belonging to the authenticated user.\n\nEach entry exposes its workspace scope via `scopes`. Every scope entry carries a `scope_type`:\n- `workspace` — the key is explicitly scoped to that workspace, with its own per-workspace permission (`viewer`, `editor`, or `owner`).\n- `global` — the key has no explicit scope rows and reaches every workspace you can access; `scopes` then lists those workspaces with your own current role on each (the effective access ceiling). A global key never mixes the two types.","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create API key","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/keys","href":"/api-reference/api-keys/create-api-key"},{"title":"Retrieve API key","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/keys/{id}","href":"/api-reference/api-keys/retrieve-api-key"},{"title":"Update API key","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml patch /api/v3/keys/{id}","href":"/api-reference/api-keys/update-api-key"},{"title":"Revoke API key","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml delete /api/v3/keys/{id}","href":"/api-reference/api-keys/revoke-api-key"}]},{"group":"Budget","pages":[{"title":"Get company budget","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/billing/budget","href":"/api-reference/budget/get-company-budget"},{"title":"Create or update company budget","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml put /api/v3/billing/budget","href":"/api-reference/budget/create-or-update-company-budget"},{"title":"Delete company budget","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml delete /api/v3/billing/budget","href":"/api-reference/budget/delete-company-budget"},{"title":"List budget alerts","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml get /api/v3/billing/budget/alerts","href":"/api-reference/budget/list-budget-alerts"},{"title":"Create budget alert","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml post /api/v3/billing/budget/alerts","href":"/api-reference/budget/create-budget-alert"},{"title":"Toggle all budget alerts","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml patch /api/v3/billing/budget/alerts","href":"/api-reference/budget/toggle-all-budget-alerts"},{"title":"Update budget alert","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml patch /api/v3/billing/budget/alerts/{id}","href":"/api-reference/budget/update-budget-alert"},{"title":"Delete budget alert","deprecated":null,"version":null,"openapi":"/api-reference/api-console.yaml delete /api/v3/billing/budget/alerts/{id}","href":"/api-reference/budget/delete-budget-alert"}]}]}]},{"tab":"Tutorials","pages":[{"title":"Tutorials","href":"/tutorials"}]},{"tab":"Settings","pages":[{"title":"Settings","href":"/untitled-page"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations"}]},{"tab":"MCP Server","pages":[{"title":"MCP Server","href":"/mcp-server/quickstart"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks"}]},{"tab":"Use Cases","pages":[{"title":"Use Cases","href":"/use-cases"}]},{"tab":"Legal","pages":[{"title":"Legal","href":"/legal/terms-of-use"}]},{"tab":"Support","pages":[{"title":"Support","href":"/support"}]}]},"basePath":"","title":"Get the status and result of an async extract job - LightOn Developers","deploymentId":"dpl_7AgmPo2RyRWZ68ZGceW618SWGEAz","buildId":"dpl_7AgmPo2RyRWZ68ZGceW618SWGEAz","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-wzXgrCiA.js","snippetPresets-Ctn0LgL5.js","utils-knxdv-fi.js","style-to-object-BY3JEAdk.js","utils-Szn2cJIN.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CYggQ38U.js","conditional-requirements-CFM0id0Q.js","cloneDeep-a_SFy_bM.js","_Uint8Array-CYON-SEw.js","isObject-FP1Yky1u.js","ApiExamples-Bp2XNIJ2.js","usePlaygroundInputsStore-Bv5ea2yO.js","shallow-BeX-jZPB.js","isEqual-DiyXA5rL.js","CodeSnippets-DXnnQSz3.js","CodeSnippet-Ba_bs1zd.js","getApiPlaygroundDisplay-D0IrdxIN.js","Page-Dn3dap3J.js","DynamicMarkdown-T8UDalrO.js","SectionHeading-DANTRrnD.js","icon-Mqg-z9_o.js","MethodPill-gS6fR7OH.js","getPastedJson-B3wZ4biI.js","Check2Icon-BT0wGl3r.js","axios-CsQoIw0U.js","Markdown-DUz08Fig.js","AssistantPageLink-D3sNlIci.js","dist-BbIWfytJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}