Product - API

Connect KYB workflows to your own systems

Detelio’s API helps teams connect business verification, case intake, review status, risk decisions, and evidence outputs into the onboarding and compliance systems they already use.

Webhook events • Retry-safe delivery • Audit-ready case files
Integrations

Built for production integrations

Signed webhooks, idempotent requests, audit-ready event history.

REST API
Webhooks
Signed events
Idempotency keys
JSON exports
RBAC-ready
Simple flow

Quickstart

01

Create an API key

Generate a key per environment and scope it to what you need.

02

Create a case

Send company inputs and requested checks to start the workflow.

03

Subscribe to webhooks

Receive decision and monitoring events automatically.

04

Fetch the case file

Pull a structured record for review, export, or storage.

Go from API key to review-ready case file in minutes.

Secure Access

Authentication and scopes

Secure access with scoped API keys and signed webhook events

Status indicator showing a verified checkmark icon inside a badge.
Use Bearer auth: Send keys via the Authorization header.
Status indicator showing a verified checkmark icon inside a badge.
Least privilege: Scope keys to required capabilities only.
Status indicator showing a verified checkmark icon inside a badge.
Rotation-ready: Treat keys as replaceable, not precious.
Status indicator showing a verified checkmark icon inside a badge.
Verify every event: Validate signature before processing.
Status indicator showing a verified checkmark icon inside a badge.
Dedupe by event_id: Assume “at least once” delivery.
Status indicator showing a verified checkmark icon inside a badge.
Retry-safe handlers: Idempotent processing prevents duplicates.
Status indicator showing a verified checkmark icon inside a badge.
Sandbox vs production: Separate keys per environment.
Status indicator showing a verified checkmark icon inside a badge.
Scope by workflow: Create, read, export, monitoring, admin.
Status indicator showing a verified checkmark icon inside a badge.
Audit-friendly access: Limit who can create high-privilege keys.
Resources

Core API resources

The objects you’ll use most to run KYB checks, route outcomes, and track change history

Cases

One workflow container for inputs, results, decisions, and history.

Read more
Right-facing arrow button to proceed to the next step.

Companies

Entity profiles with identifiers, registry references, and risk context.

Read more
Right-facing arrow button to proceed to the next step.

People & UBOs

Relationship-aware records for beneficial ownership and key roles.

Read more
Right-facing arrow button to proceed to the next step.

Documents

Evidence uploads, verification artifacts, and export packages.

Read more
Right-facing arrow button to proceed to the next step.

Decisions

Route outcomes (approve, restrict, escalate) with rationale fields.

Read more
Right-facing arrow button to proceed to the next step.

Events

Append-only event stream for updates, webhooks, and audit traces.

Read more
Right-facing arrow button to proceed to the next step.
Real time events

Webhooks that fit your workflow

Subscribe to lifecycle events and process updates in near real time

Event stream, not polling

Receive decisions, monitoring triggers, and export-ready signals via signed events.

At-least-once delivery

Use event_id to dedupe and make handlers idempotent.

Retry-safe processing

Backoff-friendly, queue-friendly event handling.

Signed payloads

Verify signatures before accepting events.

LIMITS

Rate limits and pagination

Predictable limits and cursor pagination for reliable integrations

Category
What to expect
Implementation notes
Rate limits
Varies by plan
Include limit headers (limit/remaining/reset) for visibility
429 responses
Too Many Requests
Return Retry-After so clients can back off safely
Idempotency
Supported for safe retries
Recommend an idempotency key for POST create-case
Pagination
Cursor-based
Prefer cursor pagination for stability as datasets change
Pagination fields
next_cursor, has_more
Client passes cursor to fetch the next page (avoid offset drift)
Filtering/sorting
Supported on list endpoints
Keep filters explicit and documented (country, status, updated_since, etc.)
Questions buyers actually ask

The API FAQ

Real questions from compliance teams evaluating Detelio. If something's missing, ask us in the demo — we'd rather over-share.

Do you provide webhooks for decisions and monitoring?

Expand section details

Yes. Subscribe to case updates, decision outcomes, monitoring triggers, and export-ready events via webhooks.

How do we avoid duplicate processing from webhooks?

Expand section details

Treat delivery as at least once. Dedupe by event_id and make handlers idempotent.

Can we separate sandbox and production?

Expand section details

Yes. Use separate API keys per environment and keep least-privilege scopes.

How do rate limits work?

Expand section details

Limits vary by plan. Handle 429 responses and respect Retry-After when provided.

What should we store for audits or reviews?

Expand section details

Store the case file and relevant event history. Exports can be used for evidence packages and review workflows.

Where should we start if we’re evaluating Detelio?

Expand section details

Start with Quickstart on this page, then review Security and Data Coverage to confirm fit.

Ready to integrate Detelio?
Get a guided walkthrough of the API flow, event model, and the case file your team will use.
Request a demo