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

List documents

Every document your key can see, a page at a time.

GEThttps://api.rowland.ai/v1/read/documents

Query parameters

  • typestringOptional

    Only documents of this type.

  • statusstringOptional

    Only documents with this status.

    One of processing, ready, failed

  • limitintegerOptional

    How many to return, 1 to 100.

    Default 25

  • starting_afterstringOptional

    A document ID: return the page after it.

Returns

200OK. For failures, see Errors.

  • datadocument[]

    The documents on this page, newest first.

  • has_moreboolean

    True when there are more. Pass the last id as starting_after to get them.

curl "https://api.rowland.ai/v1/read/documents?type=oil_gas_lease&limit=25" \
  -H "x-api-key: $ROWLAND_API_KEY"

Response200

{
  "object": "list",
  "data": [
    {
      "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.",
      "created_at": "2026-11-20T15:04:05Z"
    }
  ],
  "has_more": true
}