List a document's extractions

Required scope: documents:read.

Returns the structured data extracted from a document, ordered by type. A document has at most nine extraction types, so results usually fit on one page.

Only extractions that exist are listed; a missing type does not mean one is pending. Processing status and result availability are independent: a failed or running reprocess can keep an earlier usable result.

documents:read grants access to extracted clinical and legal fields, such as diagnoses and short narratives. Claimant SSN, date of birth, SSN last four and BNC are never included.

GET /api/v2/documents/{id}/extractions
Bearer token scope documents:read

Path parameters

· 1
id string required

Document ID.

Query parameters

· 3
limit integer · min: 1· max: 100· default: 50

Maximum number of items to return, from 1 to 100.

cursor string · min length: 1· max length: 4096

The page.next_cursor value from the previous page. Use it with the same filters; cursors expire after 24 hours.

type string · enum

Only return this extraction type.

values

  • determination_transmittal
  • decision_alj
  • decision_ac
  • denial_notice
  • determination
  • notice_of_award

Responses