Business Documents

Read Business Documents

get

Get all business documents associated with a verification session. This helps in reviewing the documents submitted by the business for verification purposes.

Query parameters

skipintegerOptionalDefault: 0

limitintegerOptionalDefault: 100

session_idany ofOptional

string · uuidOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

HTTPcURLJavaScriptPython

GET /beetlelabs-verification/business-documents/ HTTP/1.1
Host: beetlelabs.ai
Accept: */*

[
  {
    "session_id": "123e4567-e89b-12d3-a456-426614174000",
    "document_type": "ARTICLES_OF_INCORPORATION",
    "document_number": "text",
    "document_url": "text",
    "issue_date": "2025-06-06",
    "expiry_date": "2025-06-06",
    "ocr_data": "text",
    "verified": false,
    "verification_notes": "text",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "uploaded_at": "2025-06-06T14:21:26.193Z"
  }
]

Create Business Document

post

Upload business documents for KYB verification. This can include registration certificates, tax documents, or other official business papers. These documents are used to verify the legitimacy of the business.

Body

session_idstring · uuidRequired

document_typestring · enumRequiredPossible values:

document_numberany ofOptional

stringOptional

or

nullOptional

document_urlstringRequired

issue_dateany ofOptional

string · dateOptional

or

nullOptional

expiry_dateany ofOptional

string · dateOptional

or

nullOptional

ocr_dataany ofOptional

stringOptional

or

nullOptional

verifiedbooleanOptionalDefault: false

verification_notesany ofOptional

stringOptional

or

nullOptional

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

HTTPcURLJavaScriptPython

POST /beetlelabs-verification/business-documents/ HTTP/1.1
Host: beetlelabs.ai
Content-Type: application/json
Accept: */*
Content-Length: 260

{
  "session_id": "123e4567-e89b-12d3-a456-426614174000",
  "document_type": "ARTICLES_OF_INCORPORATION",
  "document_number": "text",
  "document_url": "text",
  "issue_date": "2025-06-06",
  "expiry_date": "2025-06-06",
  "ocr_data": "text",
  "verified": false,
  "verification_notes": "text"
}

{
  "session_id": "123e4567-e89b-12d3-a456-426614174000",
  "document_type": "ARTICLES_OF_INCORPORATION",
  "document_number": "text",
  "document_url": "text",
  "issue_date": "2025-06-06",
  "expiry_date": "2025-06-06",
  "ocr_data": "text",
  "verified": false,
  "verification_notes": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "uploaded_at": "2025-06-06T14:21:26.193Z"
}

Read Business Document

get

Path parameters

document_idstring · uuidRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

HTTPcURLJavaScriptPython

GET /beetlelabs-verification/business-documents/{document_id} HTTP/1.1
Host: beetlelabs.ai
Accept: */*

{
  "session_id": "123e4567-e89b-12d3-a456-426614174000",
  "document_type": "ARTICLES_OF_INCORPORATION",
  "document_number": "text",
  "document_url": "text",
  "issue_date": "2025-06-06",
  "expiry_date": "2025-06-06",
  "ocr_data": "text",
  "verified": false,
  "verification_notes": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "uploaded_at": "2025-06-06T14:21:26.193Z"
}

Update Business Document

put

Path parameters

document_idstring · uuidRequired

Body

document_numberany ofOptional

stringOptional

or

nullOptional

issue_dateany ofOptional

string · dateOptional

or

nullOptional

expiry_dateany ofOptional

string · dateOptional

or

nullOptional

ocr_dataany ofOptional

stringOptional

or

nullOptional

verifiedany ofOptional

booleanOptional

or

nullOptional

verification_notesany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

put

HTTPcURLJavaScriptPython

PUT /beetlelabs-verification/business-documents/{document_id} HTTP/1.1
Host: beetlelabs.ai
Content-Type: application/json
Accept: */*
Content-Length: 141

{
  "document_number": "text",
  "issue_date": "2025-06-06",
  "expiry_date": "2025-06-06",
  "ocr_data": "text",
  "verified": true,
  "verification_notes": "text"
}

{
  "session_id": "123e4567-e89b-12d3-a456-426614174000",
  "document_type": "ARTICLES_OF_INCORPORATION",
  "document_number": "text",
  "document_url": "text",
  "issue_date": "2025-06-06",
  "expiry_date": "2025-06-06",
  "ocr_data": "text",
  "verified": false,
  "verification_notes": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "uploaded_at": "2025-06-06T14:21:26.193Z"
}

Delete Business Document

delete

Path parameters

document_idstring · uuidRequired

Responses

204

Successful Response

422

Validation Error

application/json

delete

HTTPcURLJavaScriptPython

DELETE /beetlelabs-verification/business-documents/{document_id} HTTP/1.1
Host: beetlelabs.ai
Accept: */*

No content