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

Upload a document

Send a file. Rowland reads it, detects its type and extracts its fields in the background.

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

Form fields

  • filefileRequired

    The document, sent as multipart/form-data. PDF, Word, text, spreadsheets and scanned images, up to 50 MB.

  • typestringOptional

    The document type, if you already know it, such as oil_gas_lease or division_order. Leave it out and Rowland works it out.

  • tagsstring[]Optional

    Labels of your own, as a JSON array.

  • metadataobjectOptional

    Your own keys and values, as a JSON object, such as a lease number or tract ID. Returned with the document.

Returns

202Accepted: the work continues in the background. For failures, see Errors.

  • idstring

    The document ID, starting doc_.

  • statusstring

    processing while Rowland reads it, then ready or failed.

  • typestring | null

    The document type, once Rowland has worked it out.

curl -X POST "https://api.rowland.ai/v1/read/documents" \
  -H "x-api-key: $ROWLAND_API_KEY" \
  -F 'file=@whitfield-lease.pdf' \
  -F 'tags=["reeves-county", "2026-acquisition"]' \
  -F 'metadata={"lease_number": "TX-RV-0417"}'

Response202

{
  "object": "document",
  "id": "doc_2Hq8kLm4Vt",
  "name": "whitfield-lease.pdf",
  "status": "processing",
  "type": null,
  "page_count": 6,
  "summary": null,
  "tags": [
    "reeves-county",
    "2026-acquisition"
  ],
  "metadata": {
    "lease_number": "TX-RV-0417"
  },
  "created_at": "2026-11-20T15:04:05Z"
}