Document review is a lightweight workflow for any file that needs a human sign-off - contracts, proof-of-delivery, inspection reports. It supports multi-round revisions and emits webhooks on every decision.

​
When to use it

  • A seller uploads a delivery receipt and the buyer must approve before release.
  • An operator reviews a KYC override request.
  • A platform admin approves a marketing asset before it goes live.
For identity and source-of-funds checks, use the dedicated KYC and SoF flows instead - they’re tuned for those specific evidence types.

​
Lifecycle

​
Create a 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..."]
  }'

​
Approve / reject / request revision

curl -X PATCH https://api.geldstuck.com/v1/document-review/dr_01HX3ZQ.../approve \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "note": "Signature matches records." }'
Every action records to the review’s revisions[] array - so you always have a complete audit trail.

​
Webhook events

  • document_review.submitted
  • document_review.approved
  • document_review.rejected
  • document_review.revision_requested
All include the full review record so you can drive UI updates without a follow-up GET.