Fiat

Initiate KYB verification

Changed on

Generates a hosted KYB link for the organization and returns the current KYB status snapshot.

post/v1/organizations/{organization_id}/kyb/links

Request

  • Base URL
    https://api.privy.io
  • URL
    https://api.privy.io/v1/organizations/{organization_id}/kyb/links
  • Auth
    HTTP basic

Path parameters

organization_idstring required

The ID of the organization.

Headers

privy-app-idstring required

ID of your Privy app.

Request body

provider'bridge' required

KYC/KYB provider identifier.

environment'production' | 'sandbox'

Provider environment (production or sandbox).

emailstring email required

Email address for the organization.

business_namestring

Legal name of the business.

endorsementsKyxEndorsementName[]

Endorsements to request during KYB.

redirect_uristring uri

URI to redirect after completing KYB.

client_agreement_idstring

Client-side agreement ID for ToS acceptance.

Example request

{
  "endorsements": [
    "sepa"
  ]
}

Response

KYB status snapshot including the hosted verification link.

provider'bridge' required

KYC/KYB provider identifier.

environment'production' | 'sandbox' required

Provider environment (production or sandbox).

statusstring required

KYC/KYB status for the user.

requirements_duestring[] required

Top-level items still needed (e.g. link a bank account).

future_requirements_duestring[] required

Items that will be required in the future.

Example response

{
  "status": "approved",
  "tos": {
    "status": "approved"
  },
  "endorsements": [
    {
      "name": "sepa",
      "status": "approved"
    }
  ],
  "capabilities": {
    "payin_crypto": "active",
    "payout_crypto": "active",
    "payin_fiat": "active",
    "payout_fiat": "active"
  },
  "kyb": {
    "status": "approved"
  }
}

Changes