1. Compliance
QSTOD
  • Integrations
    • General
  • Identity
    • Platform liveness probe
      GET
    • Get JSON Web Key Set
      GET
    • Login with identifier and password
      POST
    • Logout and invalidate refresh token
      POST
    • Verify MFA during login
      POST
    • Refresh access token
      POST
    • Register a new user
      POST
    • Initiate step-up authentication
      POST
    • Verify step-up MFA and issue step-up token
      POST
    • Verify email OTP
      POST
    • Verify phone OTP
      POST
    • Platform liveness probe
      GET
    • Get current user profile
      GET
    • GET /v1/users/me/mfa
      GET
    • PATCH /v1/users/me/mfa
      PATCH
    • DELETE /v1/users/me/mfa/totp
      DELETE
    • POST /v1/users/me/mfa/totp/confirm
      POST
    • POST /v1/users/me/mfa/totp/setup
      POST
    • Change password (step-up required)
      POST
    • Update user profile
      PATCH
  • Finance
    • List openable account types
    • List user accounts
    • Open account (step-up required)
    • Aggregated balance history across accounts
    • Submit account open request
    • List my account open requests
    • Get accounts summary totals
    • Get account details
    • Account balance history
    • List account ledger transactions
    • List issuable card products
    • List user cards
    • Issue card on existing account (step-up required)
    • Open account and issue card (step-up required)
    • Get card details
    • Reveal card CVV (step-up required)
    • Reveal card number
    • Block or unblock card
    • List recent transfer recipients
    • Search transactions and recipients
    • List available transfer types
    • Create transfer (step-up required)
    • List user transfers
    • Quote transfer fees and FX
    • Get transfer details
    • Cancel pending transfer (step-up required)
  • Admin
    • Finance
      • List pending account requests
      • Review account request
      • List account types
      • Create account type
      • Get account type
      • Update account type
      • Delete account type
      • List accounts
      • Open account for user
      • Count accounts
      • Get account detail
      • Clear AML flag on account
      • Close, block, or unblock account
      • List account ledger transactions
      • List account transfers
      • List card payment systems
      • Create card payment system
      • Get card payment system
      • Update card payment system
      • List card products
      • Create card product
      • Get card product
      • Update card product
      • Issue card (admin)
      • Open account and issue card (admin)
      • Block or unblock card (admin)
      • Create fee rule
      • List fee rules
      • Get fee rule
      • Update fee rule
      • List FX rates
      • Upsert FX rate
      • List transfer type configuration
      • Update transfer type configuration
      • Create admin credit/debit adjustment
      • Count transfers by status
      • List pending transfers
      • Get transfer details (admin)
      • Cancel pending transfer
      • Execute pending transfer
      • Reject pending transfer
      • Export ledger transaction statement
    • AML
      • List AML flags
      • Count AML flags
      • Get AML flag
      • Clear or mark false positive on AML flag
      • List AML rules
      • Create AML rule
      • Get AML rule
      • Update AML rule
      • Delete AML rule
    • Crypto
      • List crypto wallets (admin)
      • Refresh wallet balance (admin)
    • Compliance
      • List KYB applications
      • Get KYB application by user
      • Count KYB applications
      • Get KYB application details
      • Review KYB application
      • List KYC applications
      • Get KYC application by user
      • Count KYC applications
      • Get KYC application details
      • Review KYC application
    • Notifications
      • Send admin message to user
      • List notification templates
      • Create notification template
      • List template variables
      • Get notification template
      • Update notification template
      • Delete notification template
      • List notification types
      • Create notification type
      • Update notification type
    • Identity
      • List permission action catalog
      • List users (admin)
      • Create admin user
      • Count users (admin)
      • Get user details (admin)
      • Update user profile (admin)
      • Get user permissions
      • Grant permissions
      • Revoke permissions
      • Promote user to admin
      • Block or unblock user
    • Tickets
      • List tickets (admin)
      • Get ticket (admin)
      • Close ticket
      • Reply to ticket (admin)
      • POST /v1/admin/tickets/{id}/messages/{message_id}/attachments
      • POST /v1/admin/tickets/{id}/messages/{message_id}/attachments/upload-url
      • POST /v1/admin/tickets/{id}/messages/{message_id}/attachments/{attachment_id}/confirm
  • Crypto
    • Get crypto portfolio balance
    • Get crypto balance history snapshots
    • List crypto assets and ensure wallets
    • List crypto deposits
    • Create crypto order from quote
    • List crypto orders
    • Get crypto order
    • Get buy/sell quote
    • List crypto transactions
    • List user crypto wallets
    • Create crypto withdrawal (step-up required)
    • Privy custodian webhook
  • Compliance
    • Submit KYB application
      POST
    • Get my KYB application
      GET
    • POST /v1/kyb/applications/{id}/documents
      POST
    • POST /v1/kyb/applications/{id}/documents/upload-url
      POST
    • POST /v1/kyb/applications/{id}/documents/{document_id}/confirm
      POST
    • Submit KYC application
      POST
    • Get my KYC application
      GET
    • Get KYC draft prefilled from profile
      GET
    • POST /v1/kyc/applications/{id}/documents
      POST
    • POST /v1/kyc/applications/{id}/documents/upload-url
      POST
    • POST /v1/kyc/applications/{id}/documents/{document_id}/confirm
      POST
    • Skip KYC when allowed
      POST
  • Notifications
    • List in-app notifications
    • Get notification channel preferences
    • Update notification preferences
    • Mark all notifications as read
    • Mark notification as read
  • Tickets
    • Create support ticket
    • List user tickets
    • Get ticket with messages
    • Add message to ticket
    • POST /v1/tickets/{id}/messages/{message_id}/attachments
    • POST /v1/tickets/{id}/messages/{message_id}/attachments/upload-url
    • POST /v1/tickets/{id}/messages/{message_id}/attachments/{attachment_id}/confirm
  • Schemas
    • Problem
    • Address
    • RegisterRequest
    • LoginRequest
    • MFAVerifyRequest
    • OpenAccountRequest
    • TransferRequest
    • CryptoWithdrawalRequest
    • CreateTicketRequest
    • KYCSubmitRequest
    • KYBSubmitRequest
    • AdminTransferAdjustRequest
    • CountResponse
    • MessageResponse
    • TokenResponse
    • RegisterResponse
    • LoginResponse
    • StepUpInitResponse
    • StepUpVerifyResponse
    • UserProfile
    • UserProfileDetails
    • MFASettings
    • TOTPSetupResponse
    • JWKSResponse
    • AdminUser
    • AdminUserList
    • PermissionActionsResponse
    • UserPermissionsResponse
    • AccountType
    • AccountTypeList
    • TransferTypeConfig
    • TransferTypeList
    • CardProduct
    • CardProductList
    • UserAccount
    • UserAccountList
    • AccountsSummary
    • UserAccountDetail
    • AccountOpenRequest
    • AccountOpenRequestList
    • Transaction
    • TransactionListResponse
    • StatementLine
    • TransactionStatementList
    • BalancePoint
    • BalanceHistory
    • AllAccountsBalanceHistory
    • Card
    • CardList
    • CardNumberResponse
    • CardCVVResponse
    • CardWithAccountResponse
    • Transfer
    • AdminTransfer
    • TransferList
    • AdminTransferList
    • TransferQuote
    • RecentRecipient
    • RecentRecipientList
    • SearchResponse
    • AdminAccount
    • AdminAccountList
    • AdminAccountDetail
    • FeeRule
    • FeeRuleList
    • FxRate
    • FxRateList
    • CardPaymentSystem
    • CardPaymentSystemList
    • AdminCardProduct
    • AdminCardProductList
    • AMLRule
    • AMLRuleList
    • AMLFlag
    • AMLFlagList
    • Notification
    • NotificationListResponse
    • NotificationPreferencesResponse
    • NotificationType
    • NotificationTypeList
    • NotificationTemplate
    • NotificationTemplateList
    • TemplateVariablesResponse
    • TicketSummary
    • TicketListResponse
    • TicketDetail
    • TicketMessage
    • TicketCloseResponse
    • UploadURLResponse
    • DocumentCreatedResponse
    • AttachmentCreatedResponse
    • KYCApplication
    • KYCApplicationDetail
    • KYCApplicationList
    • KYBApplication
    • KYBApplicationDetail
    • KYBApplicationList
    • KYCDraftResponse
    • KYCStatusResponse
    • KYCSubmitResponse
    • CryptoAsset
    • CryptoWallet
    • CryptoAssetsResponse
    • CryptoWalletList
    • CryptoAccountBalance
    • CryptoBalanceSnapshots
    • CryptoTransaction
    • CryptoTransactionList
    • CryptoQuote
    • CryptoOrder
    • CryptoOrderList
    • CryptoWithdrawal
    • CryptoDeposit
    • CryptoDepositList
    • AdminCryptoWallet
    • AdminCryptoWalletList
    • AdminCryptoWalletBalance
    • HealthResponse
  1. Compliance

Submit KYB application

POST
/v1/kyb/applications
Submits KYB business verification. Required: company details, legal address, at least one beneficial owner. Total ownership_percent across owners must not exceed 100%.
Authentication: Bearer JWT (user session).

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
KYB submitted
Bodyapplication/json

🟠400BadRequest
🟠401Unauthorized
🟠403Forbidden
🟠404NotFound
🟠409Conflict
🔴500InternalError
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v1/kyb/applications' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "company_name": "string",
    "registration_number": "string",
    "country": "st",
    "business_type": "string",
    "legal_address": {
        "street": "string",
        "city": "string",
        "postal_code": "string",
        "country": "st"
    },
    "beneficial_owners": [
        {}
    ]
}'
Response Response Example
201 - Example 1
{
    "application_id": "48ac72d0-a829-4896-a067-dcb1c2b0f30c",
    "status": "string",
    "next_step": "string"
}
Modified at 2026-06-23 04:24:01
Previous
Privy custodian webhook
Next
Get my KYB application
Built with