Home

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
get
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-07-30",
    "expiry_date": "2025-07-30",
    "ocr_data": "text",
    "verified": false,
    "verification_notes": "text",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "uploaded_at": "2025-07-30T17:02:21.494Z"
  }
]

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
post
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-07-30",
  "expiry_date": "2025-07-30",
  "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-07-30",
  "expiry_date": "2025-07-30",
  "ocr_data": "text",
  "verified": false,
  "verification_notes": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "uploaded_at": "2025-07-30T17:02:21.494Z"
}

Read Business Document

get
Path parameters
document_idstring · uuidRequired
Responses
200
Successful Response
application/json
get
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-07-30",
  "expiry_date": "2025-07-30",
  "ocr_data": "text",
  "verified": false,
  "verification_notes": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "uploaded_at": "2025-07-30T17:02:21.494Z"
}

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
put
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-07-30",
  "expiry_date": "2025-07-30",
  "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-07-30",
  "expiry_date": "2025-07-30",
  "ocr_data": "text",
  "verified": false,
  "verification_notes": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "uploaded_at": "2025-07-30T17:02:21.494Z"
}

Delete Business Document

delete
Path parameters
document_idstring · uuidRequired
Responses
204
Successful Response
delete
DELETE /beetlelabs-verification/business-documents/{document_id} HTTP/1.1
Host: beetlelabs.ai
Accept: */*

No content
PreviousDirectorsNextFlow Config