Directors

Read Directors

get

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/directors/ HTTP/1.1
Host: beetlelabs.ai
Accept: */*

[
  {
    "session_id": "123e4567-e89b-12d3-a456-426614174000",
    "full_name": "text",
    "date_of_birth": "2025-07-30",
    "nationality": "text",
    "position": "text",
    "residential_address": "text",
    "id_document_type": "PASSPORT",
    "id_document_number": "text",
    "id_document_url": "text",
    "id_document_back_path": "text",
    "liveness_check_path": "text",
    "verification_notes": "text",
    "consent": false,
    "id": "123e4567-e89b-12d3-a456-426614174000"
  }
]

Create Director

post

Body

session_idstring · uuidRequired

full_namestringRequired

date_of_birthany ofOptional

string · dateOptional

or

nullOptional

nationalitystringRequired

positionstringRequired

residential_addressany ofOptional

stringOptional

or

nullOptional

id_document_typeany ofOptional

string · enumOptionalPossible values:

or

nullOptional

id_document_numberany ofOptional

stringOptional

or

nullOptional

id_document_urlany ofOptional

stringOptional

or

nullOptional

id_document_back_pathany ofOptional

stringOptional

or

nullOptional

liveness_check_pathany ofOptional

stringOptional

or

nullOptional

verification_notesany ofOptional

stringOptional

or

nullOptional

consentany ofOptionalDefault: false

booleanOptional

or

nullOptional

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

HTTPcURLJavaScriptPython

POST /beetlelabs-verification/directors/ HTTP/1.1
Host: beetlelabs.ai
Content-Type: application/json
Accept: */*
Content-Length: 356

{
  "session_id": "123e4567-e89b-12d3-a456-426614174000",
  "full_name": "text",
  "date_of_birth": "2025-07-30",
  "nationality": "text",
  "position": "text",
  "residential_address": "text",
  "id_document_type": "PASSPORT",
  "id_document_number": "text",
  "id_document_url": "text",
  "id_document_back_path": "text",
  "liveness_check_path": "text",
  "verification_notes": "text",
  "consent": false
}

{
  "session_id": "123e4567-e89b-12d3-a456-426614174000",
  "full_name": "text",
  "date_of_birth": "2025-07-30",
  "nationality": "text",
  "position": "text",
  "residential_address": "text",
  "id_document_type": "PASSPORT",
  "id_document_number": "text",
  "id_document_url": "text",
  "id_document_back_path": "text",
  "liveness_check_path": "text",
  "verification_notes": "text",
  "consent": false,
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Read Director

get

Path parameters

director_idstring · uuidRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

HTTPcURLJavaScriptPython

GET /beetlelabs-verification/directors/{director_id} HTTP/1.1
Host: beetlelabs.ai
Accept: */*

{
  "session_id": "123e4567-e89b-12d3-a456-426614174000",
  "full_name": "text",
  "date_of_birth": "2025-07-30",
  "nationality": "text",
  "position": "text",
  "residential_address": "text",
  "id_document_type": "PASSPORT",
  "id_document_number": "text",
  "id_document_url": "text",
  "id_document_back_path": "text",
  "liveness_check_path": "text",
  "verification_notes": "text",
  "consent": false,
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Update Director

put

Path parameters

director_idstring · uuidRequired

Body

full_nameany ofOptional

stringOptional

or

nullOptional

date_of_birthany ofOptional

string · dateOptional

or

nullOptional

nationalityany ofOptional

stringOptional

or

nullOptional

positionany ofOptional

stringOptional

or

nullOptional

residential_addressany ofOptional

stringOptional

or

nullOptional

id_document_typeany ofOptional

string · enumOptionalPossible values:

or

nullOptional

id_document_numberany ofOptional

stringOptional

or

nullOptional

id_document_urlany ofOptional

stringOptional

or

nullOptional

id_document_back_pathany ofOptional

stringOptional

or

nullOptional

liveness_check_pathany ofOptional

stringOptional

or

nullOptional

verification_notesany ofOptional

stringOptional

or

nullOptional

consentany ofOptional

booleanOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

put

HTTPcURLJavaScriptPython

PUT /beetlelabs-verification/directors/{director_id} HTTP/1.1
Host: beetlelabs.ai
Content-Type: application/json
Accept: */*
Content-Length: 303

{
  "full_name": "text",
  "date_of_birth": "2025-07-30",
  "nationality": "text",
  "position": "text",
  "residential_address": "text",
  "id_document_type": "PASSPORT",
  "id_document_number": "text",
  "id_document_url": "text",
  "id_document_back_path": "text",
  "liveness_check_path": "text",
  "verification_notes": "text",
  "consent": true
}

{
  "session_id": "123e4567-e89b-12d3-a456-426614174000",
  "full_name": "text",
  "date_of_birth": "2025-07-30",
  "nationality": "text",
  "position": "text",
  "residential_address": "text",
  "id_document_type": "PASSPORT",
  "id_document_number": "text",
  "id_document_url": "text",
  "id_document_back_path": "text",
  "liveness_check_path": "text",
  "verification_notes": "text",
  "consent": false,
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Delete Director

delete

Path parameters

director_idstring · uuidRequired

Responses

204

Successful Response

422

Validation Error

application/json

delete

HTTPcURLJavaScriptPython

DELETE /beetlelabs-verification/directors/{director_id} HTTP/1.1
Host: beetlelabs.ai
Accept: */*

No content