get
https://api.bynn.com/v1/dossiers
Returns a paginated list of the organization's dossiers (KYC, KYB and doc),
most recent first, with optional search and filtering. Each row is a
lightweight summary — call GET /dossiers/:id for the full detail of a single
dossier (media, applicants, identity documents, liveness images).
Query parameters
search— optional, case-insensitive match on the dossier name, humanized
token, or your customer reference (customer_identification).status— optional business status filter (open,approved,rejected, …).type— optional dossier type filter (kyc,kyb,doc).date_from/date_to— optional ISO 8601 created-at range.page— optional, 1-based page number (default 1, max 1000).per_page— optional, items per page (default 50, max 100).
Response
{
"dossiers": [
{
"id": "dossier_xxx",
"token": "U45XZQE9N",
"type": "kyc",
"status": "approved",
"name": "Jane Doe",
"reference": "user-123",
"risk_score": 4,
"is_test": false,
"download_status": "not_downloaded",
"documents_count": 2,
"created_at": "2025-01-20T10:30:00Z",
"updated_at": "2025-01-20T10:35:00Z",
"completed_at": "2025-01-20T10:34:00Z"
}
],
"page": 1, "per_page": 50, "total": 128, "total_pages": 3
}
Errors
401 authentication_error— missing, malformed, or revoked private key.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
200List and search dossiers