Verification Session

Get Periodic Summary

get

Path parameters

client_idintegerRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get/verification-session/verification-summary-periodic/{client_id}

HTTPcURLJavaScriptPython

GET /beetlelabs-verification/verification-session/verification-summary-periodic/{client_id} HTTP/1.1
Host: beetlelabs.ai
Accept: */*

{
  "weekly": [
    {
      "period": "text",
      "risk_levels": {
        "low": 0,
        "medium": 0,
        "high": 0,
        "unknown": 0
      },
      "statuses": {
        "pending": 0,
        "approved": 0,
        "rejected": 0,
        "failed": 0,
        "expired": 0
      },
      "total": 1
    }
  ],
  "monthly": [
    {
      "period": "text",
      "risk_levels": {
        "low": 0,
        "medium": 0,
        "high": 0,
        "unknown": 0
      },
      "statuses": {
        "pending": 0,
        "approved": 0,
        "rejected": 0,
        "failed": 0,
        "expired": 0
      },
      "total": 1
    }
  ],
  "yearly": [
    {
      "period": "text",
      "risk_levels": {
        "low": 0,
        "medium": 0,
        "high": 0,
        "unknown": 0
      },
      "statuses": {
        "pending": 0,
        "approved": 0,
        "rejected": 0,
        "failed": 0,
        "expired": 0
      },
      "total": 1
    }
  ],
  "overall": {
    "risk_levels": {
      "low": 0,
      "medium": 0,
      "high": 0,
      "unknown": 0
    },
    "statuses": {
      "pending": 0,
      "approved": 0,
      "rejected": 0,
      "failed": 0,
      "expired": 0
    },
    "total_sessions": 1
  },
  "metadata": {
    "risk_levels": [
      "text"
    ],
    "statuses": [
      "text"
    ],
    "time_ranges": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  }
}

List Sessions

get

Get a list of all verification sessions. You can filter by status, client ID, and date range. This helps track the progress of all verification processes.

Query parameters

pageinteger · min: 1OptionalDefault: 1

sizeinteger · max: 100OptionalDefault: 20

statusstring · enum · nullableOptionalPossible values:

client_idinteger · nullableOptional

start_datestring · date-time · nullableOptional

end_datestring · date-time · nullableOptional

Responses

200

Successful Response

application/json

client_idintegerRequired

verification_typestring · enum · nullableOptionalPossible values:

statusstring · nullableOptional

verification_config_idstring · uuid4Required

idstring · uuid4Required

session_tokenstring · nullableOptional

consent_givenbooleanOptionalDefault: false

consent_timestampstring · date-time · nullableOptional

created_atstring · date-timeRequired

completed_atstring · date-time · nullableOptional

risk_levelstring · nullableOptional

422

Validation Error

application/json

get/verification-session/

HTTPcURLJavaScriptPython

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

[
  {
    "client_id": 1,
    "verification_type": "INDIVIDUAL",
    "status": "text",
    "verification_config_id": "text",
    "id": "text",
    "session_token": "text",
    "consent_given": false,
    "consent_timestamp": "2026-07-10T17:59:58.317Z",
    "created_at": "2026-07-10T17:59:58.317Z",
    "completed_at": "2026-07-10T17:59:58.317Z",
    "personal_details": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "business_details": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "risk_level": "text",
    "verification_config": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "invitations": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  }
]

Create Session Route

post

Create a new verification session for a user. This is the first step in the verification process. It generates a unique session ID that will be used throughout the verification flow.

Body

application/json

client_idintegerRequired

verification_typestring · enum · nullableOptionalPossible values:

statusstring · enumOptionalDefault: pendingPossible values:

verification_config_idstring · uuid4Required

Responses

200

Successful Response

application/json

client_idintegerRequired

verification_typestring · enum · nullableOptionalPossible values:

statusstring · nullableOptional

verification_config_idstring · uuid4Required

idstring · uuid4Required

session_tokenstring · nullableOptional

consent_givenbooleanOptionalDefault: false

consent_timestampstring · date-time · nullableOptional

created_atstring · date-timeRequired

completed_atstring · date-time · nullableOptional

risk_levelstring · nullableOptional

422

Validation Error

application/json

post/verification-session/

HTTPcURLJavaScriptPython

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

{
  "client_id": 1,
  "verification_type": "INDIVIDUAL",
  "status": "pending",
  "verification_config_id": "text"
}

{
  "client_id": 1,
  "verification_type": "INDIVIDUAL",
  "status": "text",
  "verification_config_id": "text",
  "id": "text",
  "session_token": "text",
  "consent_given": false,
  "consent_timestamp": "2026-07-10T17:59:58.317Z",
  "created_at": "2026-07-10T17:59:58.317Z",
  "completed_at": "2026-07-10T17:59:58.317Z",
  "personal_details": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "business_details": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "id_document": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "liveness_check": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "address_proof": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "business_documents": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "ultimate_beneficial_owners": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "directors": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "invitations": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "risk_level": "text"
}

Get Session

get

Path parameters

session_idstringRequired

Query parameters

include_relationshipsbooleanOptional

Load related documents

Default: false

Responses

200

Successful Response

application/json

client_idintegerRequired

verification_typestring · enum · nullableOptionalPossible values:

statusstring · nullableOptional

verification_config_idstring · uuid4Required

idstring · uuid4Required

session_tokenstring · nullableOptional

consent_givenbooleanOptionalDefault: false

consent_timestampstring · date-time · nullableOptional

created_atstring · date-timeRequired

completed_atstring · date-time · nullableOptional

risk_levelstring · nullableOptional

422

Validation Error

application/json

get/verification-session/{session_id}

HTTPcURLJavaScriptPython

GET /beetlelabs-verification/verification-session/{session_id} HTTP/1.1
Host: beetlelabs.ai
Accept: */*

{
  "client_id": 1,
  "verification_type": "INDIVIDUAL",
  "status": "text",
  "verification_config_id": "text",
  "id": "text",
  "session_token": "text",
  "consent_given": false,
  "consent_timestamp": "2026-07-10T17:59:58.317Z",
  "created_at": "2026-07-10T17:59:58.317Z",
  "completed_at": "2026-07-10T17:59:58.317Z",
  "personal_details": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "business_details": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "id_document": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "liveness_check": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "address_proof": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "business_documents": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "ultimate_beneficial_owners": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "directors": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "invitations": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "risk_level": "text"
}

Delete Session

delete

Path parameters

session_idstringRequired

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

delete/verification-session/{session_id}

HTTPcURLJavaScriptPython

DELETE /beetlelabs-verification/verification-session/{session_id} HTTP/1.1
Host: beetlelabs.ai
Accept: */*

No content

Update Session

patch

Path parameters

session_idstringRequired

Body

application/json

statusstring · enum · nullableOptionalPossible values:

rejection_reasonstring · nullableOptional

completed_atstring · date-time · nullableOptional

consent_givenboolean · nullableOptional

consent_timestampstring · date-time · nullableOptional

session_tokenstring · nullableOptional

risk_levelstring · enum · nullableOptionalPossible values:

Responses

200

Successful Response

application/json

client_idintegerRequired

verification_typestring · enum · nullableOptionalPossible values:

statusstring · nullableOptional

verification_config_idstring · uuid4Required

idstring · uuid4Required

session_tokenstring · nullableOptional

consent_givenbooleanOptionalDefault: false

consent_timestampstring · date-time · nullableOptional

created_atstring · date-timeRequired

completed_atstring · date-time · nullableOptional

risk_levelstring · nullableOptional

422

Validation Error

application/json

patch/verification-session/{session_id}

HTTPcURLJavaScriptPython

PATCH /beetlelabs-verification/verification-session/{session_id} HTTP/1.1
Host: beetlelabs.ai
Content-Type: application/json
Accept: */*
Content-Length: 198

{
  "status": "pending",
  "rejection_reason": "text",
  "completed_at": "2026-07-10T17:59:58.317Z",
  "consent_given": true,
  "consent_timestamp": "2026-07-10T17:59:58.317Z",
  "session_token": "text",
  "risk_level": "low"
}

{
  "client_id": 1,
  "verification_type": "INDIVIDUAL",
  "status": "text",
  "verification_config_id": "text",
  "id": "text",
  "session_token": "text",
  "consent_given": false,
  "consent_timestamp": "2026-07-10T17:59:58.317Z",
  "created_at": "2026-07-10T17:59:58.317Z",
  "completed_at": "2026-07-10T17:59:58.317Z",
  "personal_details": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "business_details": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "id_document": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "liveness_check": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "address_proof": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "business_documents": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "ultimate_beneficial_owners": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "directors": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "invitations": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "risk_level": "text"
}

Invite Users

post

Send verification invites to users via email and/or SMS. You can invite individual users or bulk invite multiple users using a CSV file. Each invite contains a unique link for the user to start their verification process.

Body

multipart/form-data

invite_typestring · enumRequiredPossible values:

flow_config_idstringRequired

client_idintegerRequired

emailstring · nullableRequired

phonestring · nullableRequired

business_namestring · nullableRequired

existing_businessboolean · nullableRequired

csv_filestring · binary · nullableOptional

Responses

200

Successful Response

application/json

countintegerRequired

422

Validation Error

application/json

post/verification-session/invite

HTTPcURLJavaScriptPython

POST /beetlelabs-verification/verification-session/invite HTTP/1.1
Host: beetlelabs.ai
Content-Type: multipart/form-data
Accept: */*
Content-Length: 158

{
  "invite_type": "bulk",
  "flow_config_id": "text",
  "client_id": 1,
  "email": "text",
  "phone": "text",
  "business_name": "text",
  "existing_business": true,
  "csv_file": "binary"
}

{
  "invitations": [
    {
      "id": "text",
      "session_id": "text",
      "recipient_email": "text",
      "recipient_phone": "text",
      "unique_url": "text",
      "sent_at": "2026-07-10T17:59:58.317Z",
      "delivered": true
    }
  ],
  "count": 1
}

Open Chat Interface

get

Path parameters

session_idstringRequired

Query parameters

tokenstringRequired

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

get/verification-session/verify/{session_id}

HTTPcURLJavaScriptPython

GET /beetlelabs-verification/verification-session/verify/{session_id}?token=text HTTP/1.1
Host: beetlelabs.ai
Accept: */*

No content

List Invites

get

Query parameters

client_idintegerOptional

pageinteger · min: 1OptionalDefault: 1

sizeinteger · max: 100OptionalDefault: 20

Responses

200

Successful Response

application/json

totalintegerRequired

pageintegerRequired

sizeintegerRequired

422

Validation Error

application/json

get/verification-session/invites/

HTTPcURLJavaScriptPython

GET /beetlelabs-verification/verification-session/invites/ HTTP/1.1
Host: beetlelabs.ai
Accept: */*

{
  "invites": [
    {
      "id": "text",
      "session_id": "text",
      "recipient_email": "text",
      "recipient_phone": "text",
      "unique_url": "text",
      "sent_at": "2026-07-10T17:59:58.317Z",
      "delivered": true
    }
  ],
  "total": 1,
  "page": 1,
  "size": 1
}