LogoLogo
Home
  • Beetlelabs
  • Personal Details(KYC)
  • UBOs
  • Directors
  • Business Documents
  • Flow Config
  • ID,Address Document Proof
  • Liveness
  • Business details(KYB)
  • Verification Session
  • Models
Powered by GitBook
LogoLogo

Company

  • Home
  • Team
  • Blog

Social

  • LinkedIn
  • Twitter

Copyright © 2025 BeetleLabs.Ai | All Rights Reserved

On this page
Export as PDF

Verification Session

PreviousBusiness details(KYB)NextModels

Get Periodic Summary

get
Path parameters
client_idintegerRequired
Responses
200
Successful Response
application/json
422
Validation Error
application/json
get
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
statusany ofOptional
string · enumOptionalPossible values:
or
nullOptional
client_idany ofOptional
integerOptional
or
nullOptional
start_dateany ofOptional
string · date-timeOptional
or
nullOptional
end_dateany ofOptional
string · date-timeOptional
or
nullOptional
Responses
200
Successful Response
application/json
422
Validation Error
application/json
get
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": "2025-06-06T12:03:29.576Z",
    "created_at": "2025-06-06T12:03:29.576Z",
    "completed_at": "2025-06-06T12:03:29.576Z",
    "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"
    }
  }
]

Get Session

get
Path parameters
session_idstringRequired
Query parameters
include_relationshipsbooleanOptional

Load related documents

Default: false
Responses
200
Successful Response
application/json
422
Validation Error
application/json
get
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": "2025-06-06T12:03:29.576Z",
  "created_at": "2025-06-06T12:03:29.576Z",
  "completed_at": "2025-06-06T12:03:29.576Z",
  "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
Responseany
422
Validation Error
application/json
delete
DELETE /beetlelabs-verification/verification-session/{session_id} HTTP/1.1
Host: beetlelabs.ai
Accept: */*

No content

Open Chat Interface

get
Path parameters
session_idstringRequired
Query parameters
tokenstringRequired
Responses
200
Successful Response
application/json
Responseany
422
Validation Error
application/json
get
GET /beetlelabs-verification/verification-session/verify/{session_id} 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
422
Validation Error
application/json
get
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": "2025-06-06T12:03:29.576Z",
      "delivered": true
    }
  ],
  "total": 1,
  "page": 1,
  "size": 1
}
  • GETGet Periodic Summary
  • GETList Sessions
  • POSTCreate Session Route
  • GETGet Session
  • DELETEDelete Session
  • PATCHUpdate Session
  • POSTInvite Users
  • GETOpen Chat Interface
  • GETList Invites

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
client_idintegerRequired
verification_typeany ofOptional
string · enumOptionalPossible values:
or
nullOptional
statusstring · enumOptionalDefault: pendingPossible values:
verification_config_idstring · uuid4Required
Responses
200
Successful Response
application/json
422
Validation Error
application/json
post
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": "2025-06-06T12:03:29.576Z",
  "created_at": "2025-06-06T12:03:29.576Z",
  "completed_at": "2025-06-06T12:03:29.576Z",
  "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"
}

Update Session

patch
Path parameters
session_idstringRequired
Body
statusany ofOptional
string · enumOptionalPossible values:
or
nullOptional
rejection_reasonany ofOptional
stringOptional
or
nullOptional
completed_atany ofOptional
string · date-timeOptional
or
nullOptional
consent_givenany ofOptional
booleanOptional
or
nullOptional
consent_timestampany ofOptional
string · date-timeOptional
or
nullOptional
session_tokenany ofOptional
stringOptional
or
nullOptional
risk_levelany ofOptional
string · enumOptionalPossible values:
or
nullOptional
Responses
200
Successful Response
application/json
422
Validation Error
application/json
patch
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": "2025-06-06T12:03:29.576Z",
  "consent_given": true,
  "consent_timestamp": "2025-06-06T12:03:29.576Z",
  "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": "2025-06-06T12:03:29.576Z",
  "created_at": "2025-06-06T12:03:29.576Z",
  "completed_at": "2025-06-06T12:03:29.576Z",
  "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
invite_typestring · enumRequiredPossible values:
flow_config_idstringRequired
client_idintegerRequired
emailany ofRequired
stringOptional
or
nullOptional
phoneany ofRequired
stringOptional
or
nullOptional
business_nameany ofRequired
stringOptional
or
nullOptional
existing_businessany ofRequired
booleanOptional
or
nullOptional
csv_fileany ofOptional
string · binaryOptional
or
nullOptional
Responses
200
Successful Response
application/json
422
Validation Error
application/json
post
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": "2025-06-06T12:03:29.576Z",
      "delivered": true
    }
  ],
  "count": 1
}