POSTRequires Bearer token

Analyze document

/api/ai/documents/{document_id}/analyze

Structured contract extraction (doc_type, parties, dates, amounts, clauses, obligations). async=true returns 202 { job_id, status } — poll GET /api/ai/jobs/{job_id}.

Path parameters

Field	Type	Description
document_id Required	string	Path parameter `document_id`.

Query parameters

Field	Type	Description
async	boolean	If true, returns `202` and a job id. e.g. false

Request body

This endpoint does not accept a request body.

Responses

Status	Meaning
200	Analysis
401	Missing or invalid Bearer token.

Request

curl

curl -X POST 'https://api.dkbsigns.com/api/ai/documents/uuid_or_id/analyze?async=false' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN'

Response 200

json

{
  "analysis_id": "a1",
  "document_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "type": "analyze",
  "result": {
    "doc_type": "contrat",
    "parties": []
  }
}