POST
/
v1
/
document-review
curl https://api.geldstuck.com/v1/document-review \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transactionId": "tx_01HX3ZM...",
    "documentType": "delivery_receipt",
    "domain": "escrow",
    "fileIds": ["file_01HX3ZP..."]
  }'

{
  "id": "dr_01HX3ZQ...",
  "transactionId": "tx_01HX3ZM...",
  "documentType": "delivery_receipt",
  "domain": "escrow",
  "status": "submitted",
  "fileIds": ["file_01HX3ZP..."],
  "revisions": [],
  "createdAt": "2026-04-22T12:30:00.000Z"
}
See the document review guide for the workflow.

​
Body

​
transactionId
string
Optional. Links the review to a transaction.
​
userId
string
Optional. Links the review to a user.
​
documentType
string
required
delivery_receipt, inspection_report, contract, or any custom type you’ve configured.
​
domain
string
required
High-level bucket: escrow, kyc, compliance, marketplace.
​
fileIds
array
required
File IDs from the upload endpoint.
​
metadata
object

​
Returns

A review object with status: "submitted". 
curl https://api.geldstuck.com/v1/document-review \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transactionId": "tx_01HX3ZM...",
    "documentType": "delivery_receipt",
    "domain": "escrow",
    "fileIds": ["file_01HX3ZP..."]
  }'

{
  "id": "dr_01HX3ZQ...",
  "transactionId": "tx_01HX3ZM...",
  "documentType": "delivery_receipt",
  "domain": "escrow",
  "status": "submitted",
  "fileIds": ["file_01HX3ZP..."],
  "revisions": [],
  "createdAt": "2026-04-22T12:30:00.000Z"
}