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 · Document Extraction

Get an extraction

Its status and, once it completes, its records.

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

Path parameters

  • idstringRequired

    The extraction ID.

Returns

200OK. For failures, see Errors.

  • recordsobject[]

    Once completed: the records, each with the document it came from, its values and a citation for every value.

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

Response200

{
  "object": "extraction",
  "id": "ext_9Fd2sQw7Lp",
  "status": "completed",
  "records": [
    {
      "document": "doc_2Hq8kLm4Vt",
      "values": {
        "lessor": "Mary A. Whitfield",
        "royalty": 0.1875,
        "depth_limit": "From the surface to 100 feet below the base of the Wolfcamp"
      },
      "citations": {
        "royalty": {
          "page": 2,
          "text": "three-sixteenths (3/16)"
        },
        "depth_limit": {
          "page": 3,
          "text": "from the surface to one hundred (100) feet below the base of the Wolfcamp formation"
        }
      }
    },
    {
      "document": "doc_7Rw3nPz9Xc",
      "values": {
        "lessor": "Ochoa Family Trust",
        "royalty": 0.2,
        "depth_limit": null
      },
      "citations": {
        "royalty": {
          "page": 1,
          "text": "one-fifth (1/5)"
        },
        "depth_limit": null
      }
    }
  ],
  "completed_at": "2026-11-20T15:11:27Z"
}