KYB Flows

Discover KYB Flows for Your Organization

Use these endpoints to discover which KYB flows are available to your organization before creating a KYB case.

Both endpoints:

  • Require the x-api-key header

  • Return a JSON array

  • Return [] when no matching flows exist

  • Only return flows that belong to the authenticated organization

Response Shape

Each flow is returned with the same minimal shape:

[
  {
    "id": "680dbf0d3f6c8d7f0a123456",
    "country": "US",
    "default": true
  }
]
Field
Type
Description

id

string

The KYB flow ID to pass as the flow value when creating a KYB case

country

string

The country associated with the flow

default

boolean

Whether this flow is marked as the default flow for that organization and country

List All KYB Flows

Retrieve every KYB flow available to the authenticated organization.

Endpoint

  • Method: GET

  • URL: /kyb/flows

  • Authentication: Required (x-api-key header)

Example Request

Example Response

List Default KYB Flows

Retrieve only KYB flows where default = true for the authenticated organization.

Endpoint

  • Method: GET

  • URL: /kyb/flows/default

  • Authentication: Required (x-api-key header)

Example Request

Example Response

When to Use Each Endpoint

  • Use GET /kyb/flows when you want to show all available KYB flow options for the organization.

  • Use GET /kyb/flows/default when you only need the default flow set and want to avoid hardcoding flow IDs.

Last updated