Skip to main content
Didit logo
  • Category: security & identity tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 10
  • Triggers: 0
  • Slug: DIDIT
  • Version: 00000000_00

Tools

Slug: DIDIT_CREATE_VERIFICATION_SESSIONCreate 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

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.
string
Private JSON correlation or business context stored with the session and echoed in decisions and webhooks.
string
Your stable user or business identifier; strongly recommended for grouping, duplicate suppression, and unfinished-session reuse.
string
required
Stable ID of the published workflow to run; obtain it from DIDIT_LIST_WORKFLOWS.
string
Redirect URL after verification. Didit appends the session ID and status; omit to use the workflow default.
string ("initiator" | "completer" | "both")
Device allowed to perform the final redirect: initiator, completer, or both.
object
Optional contact prefill. Notification emails remain disabled unless explicitly enabled.
object
Expected person or company details for cross-validation or KYB registry prefilling.
string
Sandbox-only scenario slug. Live applications reject this field.
string
Base64 portrait up to 2 MB for biometric-authentication or pre-OCR face-match workflows.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIDIT_GET_BILLING_BALANCERead the organization’s prepaid Didit credit balance and auto-refill settings before starting billable verification work.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIDIT_GET_BUSINESSFetch one aggregated KYB business profile by its exact vendor_data identifier.

Input Parameters

string
required
Your exact free-form business identifier. This is not a UUID unless your own identifier happens to be one.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIDIT_GET_USERFetch 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

string
required
Your exact free-form user identifier. This is not a UUID unless your own identifier happens to be one.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIDIT_GET_VERIFICATION_DECISIONRetrieve 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

string
required
Session UUID returned by session creation, listing, or a Didit webhook.
boolean
For KYC only, include the event timeline, review activity, blocklist flags, cost breakdown, and expanded workflow metadata.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIDIT_GET_WORKFLOWFetch the full configuration and pricing of one workflow version.

Input Parameters

string
required
Per-version UUID from the uuid field returned by DIDIT_LIST_WORKFLOWS, not the stable workflow_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIDIT_LIST_BUSINESSESList 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

integer
Maximum businesses to return in this page, at least 1.
string
Opaque continuation cursor returned by a previous call.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIDIT_LIST_USERSList user profiles aggregated from KYC sessions, including status, session counts, and feature summaries. Didit does not support filters on this endpoint.

Input Parameters

integer
Maximum users to return in this page, at least 1.
string
Opaque continuation cursor returned by a previous call.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIDIT_LIST_VERIFICATION_SESSIONSList and filter KYC, KYB, or standalone verification sessions. Returns one bounded page and a continuation cursor.

Input Parameters

integer
Maximum verification sessions to return in this page, at least 1.
Smart search across session IDs, numbers, names, contact data, document data, and vendor_data.
string
Latest creation date in UTC, YYYY-MM-DD; KYB uses a midnight boundary.
array
Case-sensitive session statuses to include, such as Approved or In Review.
string
Earliest creation date in UTC, YYYY-MM-DD.
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.
string
Opaque continuation cursor returned by a previous call.
string
Exact match on your user or business identifier.
string ("user" | "business")
List KYC users or KYB businesses. Call each kind separately when both are needed because Didit cannot paginate mixed results reliably.
array
Restrict results to these workflow UUIDs.
array
KYC document-issuing or KYB registry country codes.
array
Return sessions containing any of these Didit warning risk codes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIDIT_LIST_WORKFLOWSList configured verification workflow versions, their publication status, feature summary, and expected per-run pricing.

Input Parameters

integer
Maximum workflow versions to return in this page, at least 1.
string
Opaque continuation cursor returned by a previous call.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not