Skip to content

Popular

  • QuickstartDevelopers
  • AuthenticationBasics
  • WebhooksBasics
  • Upload a documentPOST /v1/read/documents
  • Get a document’s fieldsGET /v1/read/documents/{id}/fields
  • Extract your own fieldsREAD · Document Extraction
READ menu

READ · Documents

Get a document

One document: its type, summary and processing status.

GEThttps://api.rowland.ai/v1/read/documents/{id}

Path parameters

  • idstringRequired

    The document ID.

Returns

200OK. For failures, see Errors.

  • statusstring

    processing, ready or failed. Its fields are ready at ready.

  • summarystring | null

    A short summary of the document.

  • needs_reviewboolean

    True when something in the document needs a person’s judgment. See the document’s fields for what.

curl "https://api.rowland.ai/v1/read/documents/doc_2Hq8kLm4Vt" \
  -H "x-api-key: $ROWLAND_API_KEY"

Response200

{
  "object": "document",
  "id": "doc_2Hq8kLm4Vt",
  "name": "whitfield-lease.pdf",
  "status": "ready",
  "type": "oil_gas_lease",
  "page_count": 6,
  "summary": "Oil and gas lease from Mary A. Whitfield to Permian Land Co., 320 acres in Section 12, Block 7, Reeves County, Texas.",
  "needs_review": false,
  "tags": [
    "reeves-county",
    "2026-acquisition"
  ],
  "metadata": {
    "lease_number": "TX-RV-0417"
  },
  "created_at": "2026-11-20T15:04:05Z",
  "ready_at": "2026-11-20T15:05:41Z"
}