> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Didit

> Didit provides identity verification, KYC, KYB, AML, fraud prevention, and compliance APIs for onboarding and ongoing risk operations.

![Didit logo](https://mintcdn.com/composio-preview/VNLruGH5mLZqXdPH/images/toolkits/didit.svg?fit=max\&auto=format\&n=VNLruGH5mLZqXdPH\&q=85\&s=37481be5972ef443458432e7e4b35378)

* **Category:** security & identity tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `DIDIT`
* **Version:** 00000000\_00

## Tools

> [accordion] Create Verification Session
>
> **Slug:** `DIDIT_CREATE_VERIFICATION_SESSION`
>
> Create a hosted KYC or KYB verification session from a published workflow and return the URL to give the end user. This may consume Didit credits and sends an invitation email only when explicitly requested.
>
> #### Input Parameters
>
> **language** `string ("en" | "ar" | "bg" | "bn" | "bs" | "ca" | "cnr" | "cs" | "da" | "de" | "el" | "es" | "et" | "fa" | "fi" | "fr" | "he" | "hi" | "hr" | "hu" | "hy" | "id" | "it" | "ja" | "ka" | "kk" | "ko" | "ky" | "lt" | "lv" | "mk" | "mn" | "ms" | "nl" | "no" | "pl" | "pt-BR" | "pt" | "ro" | "ru" | "sk" | "sl" | "so" | "sq" | "sr" | "sv" | "th" | "tr" | "uk" | "uz" | "vi" | "zh-CN" | "zh-TW" | "zh")`
>
> Supported Didit interface language code. Omit for browser language detection.
>
> **metadata** `string`
>
> Private JSON correlation or business context stored with the session and echoed in decisions and webhooks.
>
> **vendor\_data** `string`
>
> Your stable user or business identifier; strongly recommended for grouping, duplicate suppression, and unfinished-session reuse.
>
> **workflow\_id** `string` *required*
>
> Stable ID of the published workflow to run; obtain it from DIDIT\_LIST\_WORKFLOWS.
>
> **callback\_url** `string`
>
> Redirect URL after verification. Didit appends the session ID and status; omit to use the workflow default.
>
> **callback\_method** `string ("initiator" | "completer" | "both")`
>
> Device allowed to perform the final redirect: initiator, completer, or both.
>
> **contact\_details** `object`
>
> Optional contact prefill. Notification emails remain disabled unless explicitly enabled.
>
> **expected\_details** `object`
>
> Expected person or company details for cross-validation or KYB registry prefilling.
>
> **sandbox\_scenario** `string`
>
> Sandbox-only scenario slug. Live applications reject this field.
>
> **portrait\_image\_base64** `string`
>
> Base64 portrait up to 2 MB for biometric-authentication or pre-OCR face-match workflows.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Billing Balance
>
> **Slug:** `DIDIT_GET_BILLING_BALANCE`
>
> Read the organization's prepaid Didit credit balance and auto-refill settings before starting billable verification work.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Business
>
> **Slug:** `DIDIT_GET_BUSINESS`
>
> Fetch one aggregated KYB business profile by its exact vendor\_data identifier.
>
> #### Input Parameters
>
> **vendor\_data** `string` *required*
>
> Your exact free-form business identifier. This is not a UUID unless your own identifier happens to be one.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User
>
> **Slug:** `DIDIT_GET_USER`
>
> Fetch one aggregated KYC user profile by its exact vendor\_data identifier. Returns the complete provider record, including identity summary, session aggregation, metadata, tags, and comments or activity.
>
> #### Input Parameters
>
> **vendor\_data** `string` *required*
>
> Your exact free-form user identifier. This is not a UUID unless your own identifier happens to be one.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Verification Decision
>
> **Slug:** `DIDIT_GET_VERIFICATION_DECISION`
>
> Retrieve the complete current KYC or KYB decision and all feature reports for one verification session. Feature report arrays and unknown provider fields are preserved; media URLs in the result are short-lived.
>
> #### Input Parameters
>
> **session\_id** `string` *required*
>
> Session UUID returned by session creation, listing, or a Didit webhook.
>
> **include\_events** `boolean`
>
> For KYC only, include the event timeline, review activity, blocklist flags, cost breakdown, and expanded workflow metadata.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow
>
> **Slug:** `DIDIT_GET_WORKFLOW`
>
> Fetch the full configuration and pricing of one workflow version.
>
> #### Input Parameters
>
> **workflow\_version\_id** `string` *required*
>
> Per-version UUID from the uuid field returned by DIDIT\_LIST\_WORKFLOWS, not the stable workflow\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Businesses
>
> **Slug:** `DIDIT_LIST_BUSINESSES`
>
> List business profiles aggregated from KYB sessions, including status, session counts, registry identifiers, and verification summaries. Didit does not support filters or search on this endpoint.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum businesses to return in this page, at least 1.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Users
>
> **Slug:** `DIDIT_LIST_USERS`
>
> List user profiles aggregated from KYC sessions, including status, session counts, and feature summaries. Didit does not support filters on this endpoint.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum users to return in this page, at least 1.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Verification Sessions
>
> **Slug:** `DIDIT_LIST_VERIFICATION_SESSIONS`
>
> List and filter KYC, KYB, or standalone verification sessions. Returns one bounded page and a continuation cursor.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum verification sessions to return in this page, at least 1.
>
> **search** `string`
>
> Smart search across session IDs, numbers, names, contact data, document data, and vendor\_data.
>
> **date\_to** `string`
>
> Latest creation date in UTC, YYYY-MM-DD; KYB uses a midnight boundary.
>
> **statuses** `array`
>
> Case-sensitive session statuses to include, such as Approved or In Review.
>
> **date\_from** `string`
>
> Earliest creation date in UTC, YYYY-MM-DD.
>
> **api\_service** `string ("ID_VERIFICATION" | "FACE_MATCH" | "AGE_ESTIMATION" | "FACE_SEARCH" | "POA" | "AML" | "KYB_REGISTRY" | "PASSIVE_LIVENESS" | "DATABASE_VALIDATION" | "PHONE_VERIFICATION" | "EMAIL_VERIFICATION")`
>
> Restrict standalone API sessions to one documented Didit service.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call.
>
> **vendor\_data** `string`
>
> Exact match on your user or business identifier.
>
> **session\_kind** `string ("user" | "business")`
>
> List KYC users or KYB businesses. Call each kind separately when both are needed because Didit cannot paginate mixed results reliably.
>
> **workflow\_ids** `array`
>
> Restrict results to these workflow UUIDs.
>
> **country\_codes** `array`
>
> KYC document-issuing or KYB registry country codes.
>
> **warning\_codes** `array`
>
> Return sessions containing any of these Didit warning risk codes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workflows
>
> **Slug:** `DIDIT_LIST_WORKFLOWS`
>
> List configured verification workflow versions, their publication status, feature summary, and expected per-run pricing.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum workflow versions to return in this page, at least 1.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
