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
filefileRequiredThe document, sent as multipart/form-data. PDF, Word, text, spreadsheets and scanned images, up to 50 MB.
typestringOptionalThe document type, if you already know it, such as
oil_gas_leaseordivision_order. Leave it out and Rowland works it out.tagsstring[]OptionalLabels of your own, as a JSON array.
metadataobjectOptionalYour 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.
idstringThe document ID, starting
doc_.statusstringprocessingwhile Rowland reads it, thenreadyorfailed.typestring | nullThe 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"
}