> ## Documentation Index > Fetch the complete documentation index at: https://docs.privy.io/llms.txt > Use this file to discover all available pages before exploring further. # Submit KYB data > Submits KYB verification data for the organization. Safe to call more than once: the first call creates the provider customer and later calls update it, so a partial submission can be completed incrementally. ## OpenAPI ````yaml post /v1/organizations/{organization_id}/kyb/submit openapi: 3.1.0 info: version: 0.0.1 title: Privy API description: >- REST API for Privy's wallet infrastructure — provision and manage wallets across EVM, Solana, and Bitcoin, authenticate users, sign transactions, and configure programmable policies and authorization intents. contact: name: Privy url: https://www.privy.io/ email: support@privy.io servers: - url: https://api.privy.io security: [] tags: - name: Accounts description: Operations related to asset accounts - name: Actions description: Operations related to looking up wallet actions across an app - name: Aggregations description: Operations related to aggregations for tracking and measuring metrics - name: Apps description: Operations related to app settings and allowlist management - name: Cards description: Operations related to stablecoin-backed card issuing - name: Client Auth description: OAuth token exchange and device authorization operations - name: Condition Sets description: Operations related to condition sets - name: Embedded wallets description: Operations related to embedded wallet creation and authentication - name: Fiat description: Operations related to fiat onramping and offramping - name: Intents description: Operations related to authorization intents for wallet actions - name: Key quorums description: Operations related to key quorums - name: Kraken Embed description: >- Operations for Kraken Embed integration, including quotes, trades, user management, and portfolio operations - name: OAuth description: >- OAuth 2.0 endpoints including Device Authorization Grant (RFC 8628) for CLI and limited-input device login flows - name: Organizations description: Operations related to organizations - name: Policies description: Operations related to policies - name: Shared description: Common schemas shared across resources - name: Swaps description: Operations for swapping tokens within wallets - name: Teams description: Operations related to dashboard team management - name: Transactions description: Operations related to transactions - name: User signers description: Operations related to user signers - name: Users description: Operations related to users - name: Wallet Actions description: Operations related to wallet actions - name: Wallet Automations description: Operations related to wallet automations - name: Wallets description: Operations related to wallets - name: Webhooks description: >- Webhook events that Privy sends to your configured endpoint when specific actions occur in your app - name: Yield description: >- Operations for depositing and withdrawing funds from ERC-4626 yield vaults (Morpho, Aave) paths: /v1/organizations/{organization_id}/kyb/submit: post: tags: - Fiat summary: Submit KYB data description: >- Submits KYB verification data for the organization. Safe to call more than once: the first call creates the provider customer and later calls update it, so a partial submission can be completed incrementally. operationId: submitKyb parameters: - schema: type: string description: The ID of the organization. required: true name: organization_id in: path - schema: type: string description: ID of your Privy app. required: true name: privy-app-id in: header requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/KybSubmitRequestBody' responses: '200': description: KYB status snapshot reflecting the submitted data. content: application/json: schema: $ref: '#/components/schemas/KybStatusResponse' security: - appSecretAuth: [] components: schemas: KybSubmitRequestBody: type: object properties: provider: $ref: '#/components/schemas/KyxProvider' environment: $ref: '#/components/schemas/KyxEnvironment' endorsements: type: array items: $ref: '#/components/schemas/KyxEndorsementName' maxItems: 1000 description: Endorsements to request during KYB. client_agreement_id: type: string minLength: 1 maxLength: 1024 description: Client-side agreement ID for ToS acceptance. data: $ref: '#/components/schemas/KybSubmitData' required: - provider - data additionalProperties: false description: Request body for headless KYB data submission. title: KybSubmitRequestBody x-stainless-model: fiat.kyb_submit_request_body KybStatusResponse: type: object properties: provider: $ref: '#/components/schemas/KyxProvider' environment: $ref: '#/components/schemas/KyxEnvironment' status: $ref: '#/components/schemas/KyxProviderStatus' tos: $ref: '#/components/schemas/KyxTosStatusDetail' endorsements: type: array items: $ref: '#/components/schemas/KyxEndorsement' capabilities: $ref: '#/components/schemas/KyxCapabilities' requirements_due: type: array items: type: string description: Top-level items still needed (e.g. link a bank account). future_requirements_due: type: array items: type: string description: Items that will be required in the future. kyb: $ref: '#/components/schemas/KyxVerificationStatusDetail' required: - provider - environment - status - tos - endorsements - capabilities - requirements_due - future_requirements_due - kyb description: Full KYB status for an organization with a given provider. title: KybStatusResponse x-stainless-model: fiat.kyb_status_response KyxProvider: type: string enum: - bridge description: KYC/KYB provider identifier. title: KyxProvider x-stainless-model: fiat.kyx_provider KyxEnvironment: type: string enum: - production - sandbox description: Provider environment (production or sandbox). title: KyxEnvironment x-stainless-model: fiat.kyx_environment KyxEndorsementName: type: string maxLength: 256 description: Endorsement identifier. title: KyxEndorsementName example: sepa x-stainless-model: fiat.kyx_endorsement_name KybSubmitData: type: object properties: business_legal_name: type: string minLength: 1 maxLength: 1024 description: Registered legal name as filed with government authorities. business_trade_name: type: string minLength: 1 maxLength: 1024 description: Public trading name (DBA), if different from the legal name. transliterated_business_legal_name: type: string minLength: 1 maxLength: 1024 description: >- Latin-1 transliteration of the legal name. Required for non-Latin-1 names. transliterated_business_trade_name: type: string minLength: 1 maxLength: 1024 description: >- Latin-1 transliteration of the trade name. Required for non-Latin-1 names. business_description: type: string minLength: 1 maxLength: 1024 description: Short summary of what the business does. business_type: $ref: '#/components/schemas/KybBusinessType' business_industry: type: array items: type: string minLength: 1 maxLength: 16 maxItems: 1000 description: 2022 NAICS codes describing the industries the business operates in. email: type: string maxLength: 1024 format: email description: Primary business email address. phone: type: string maxLength: 1024 description: Business phone number in E.164 format. incorporation_date: type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: Date of incorporation in YYYY-MM-DD format. is_dao: type: boolean description: Whether the business is a decentralized autonomous organization. primary_website: type: string maxLength: 1024 description: >- Primary website. If omitted, a proof_of_nature_of_business document is required. other_websites: type: array items: type: string maxLength: 1024 maxItems: 1000 description: Additional websites and social handles. registered_address: $ref: '#/components/schemas/VerificationAddress' physical_address: $ref: '#/components/schemas/VerificationAddress' transliterated_registered_address: $ref: '#/components/schemas/VerificationAddress' transliterated_physical_address: $ref: '#/components/schemas/VerificationAddress' ownership_threshold: type: integer minimum: 5 maximum: 25 description: >- Ownership percentage at which a person is treated as a beneficial owner. has_material_intermediary_ownership: type: boolean description: >- Whether an intermediate entity owner holds 25% or more of the business. publicly_traded_listings: type: array items: $ref: '#/components/schemas/KybPubliclyTradedListing' maxItems: 1000 description: Public exchange listings for the business. associated_persons: type: array items: $ref: '#/components/schemas/KybAssociatedPerson' maxItems: 1000 description: Beneficial owners, control persons, and signers. estimated_annual_revenue_usd: $ref: '#/components/schemas/KybEstimatedAnnualRevenue' expected_monthly_payments_usd: type: integer minimum: 0 description: >- Expected monthly payment volume in USD. Required for high-risk businesses. source_of_funds: $ref: '#/components/schemas/KybSourceOfFunds' source_of_funds_description: type: string minLength: 1 maxLength: 1024 description: >- Free-text detail on the source of funds. Required for high-risk businesses. account_purpose: $ref: '#/components/schemas/KybAccountPurpose' account_purpose_other: type: string minLength: 1 maxLength: 1024 description: Free-text purpose. Required when account_purpose is "other". acting_as_intermediary: type: boolean description: Whether the business moves funds on behalf of third parties. operates_in_prohibited_countries: type: boolean description: Whether the business operates in prohibited jurisdictions. high_risk_activities: type: array items: $ref: '#/components/schemas/KybHighRiskActivity' maxItems: 1000 description: High-risk activities the business engages in. high_risk_activities_explanation: type: string minLength: 1 maxLength: 1024 description: >- Explanation of the high-risk activities. Required unless the only value is "none_of_the_above". conducts_money_services: type: boolean description: Whether the business conducts money services. conducts_money_services_using_bridge: type: boolean description: >- Whether money services are conducted through the provider. Requires a flow_of_funds document when true. conducts_money_services_description: type: string minLength: 1 maxLength: 1024 description: Description of the money services conducted. compliance_screening_explanation: type: string minLength: 1 maxLength: 1024 description: Description of the AML and sanctions screening controls in place. has_foreign_tax_registration: type: boolean description: >- Whether the business is tax-registered outside its country of incorporation. regulated_activity: $ref: '#/components/schemas/KybRegulatedActivity' identifying_information: type: array items: $ref: '#/components/schemas/VerificationDocument' maxItems: 1000 description: Business tax and registration identifiers. documents: type: array items: $ref: '#/components/schemas/KybBusinessDocument' maxItems: 1000 description: Supporting documents for verification. additionalProperties: false description: >- KYB verification data for headless submission. Fields are individually optional because the provider accepts partial submissions and grants endorsements once enough data has arrived; a partial submission can be completed by calling the endpoint again. title: KybSubmitData x-stainless-model: fiat.kyb_submit_data KyxProviderStatus: type: string description: KYC/KYB status for the user. title: KyxProviderStatus example: approved x-stainless-model: fiat.kyx_provider_status KyxTosStatusDetail: type: object properties: status: $ref: '#/components/schemas/KyxTosStatus' link: type: string format: uri description: ToS acceptance link, if pending. required: - status description: Terms of Service acceptance status for a KYC or KYB flow. title: KyxTosStatusDetail x-stainless-model: fiat.kyx_tos_status_detail KyxEndorsement: type: object properties: name: $ref: '#/components/schemas/KyxEndorsementName' status: $ref: '#/components/schemas/KyxEndorsementStatus' missing: type: - array - 'null' items: type: string description: Missing requirements, or null if complete. required: - name - status - missing description: An endorsement with its approval status and missing requirements. title: KyxEndorsement x-stainless-model: fiat.kyx_endorsement KyxCapabilities: type: object properties: payin_crypto: $ref: '#/components/schemas/KyxCapabilityStatus' payout_crypto: $ref: '#/components/schemas/KyxCapabilityStatus' payin_fiat: $ref: '#/components/schemas/KyxCapabilityStatus' payout_fiat: $ref: '#/components/schemas/KyxCapabilityStatus' required: - payin_crypto - payout_crypto - payin_fiat - payout_fiat description: Capability statuses for the customer. title: KyxCapabilities x-stainless-model: fiat.kyx_capabilities KyxVerificationStatusDetail: type: object properties: status: $ref: '#/components/schemas/KyxVerificationStatus' link: type: string format: uri description: Verification link, if applicable. rejection_reasons: type: array items: type: string description: Reasons for rejection, if status is closed or action_required. required: - status description: Verification status detail for a KYC or KYB check. title: KyxVerificationStatusDetail x-stainless-model: fiat.kyx_verification_status_detail KybBusinessType: type: string minLength: 1 maxLength: 64 description: >- Legal structure of the business. Passthrough to the provider. See the [Bridge customer API reference](https://apidocs.bridge.xyz/platform/customers/customers/api) for accepted values. title: KybBusinessType example: llc x-stainless-model: fiat.kyb_business_type VerificationAddress: type: object properties: street_line_1: type: string minLength: 4 maxLength: 1024 description: Street address line 1. street_line_2: type: string minLength: 1 maxLength: 1024 description: Street address line 2. city: type: string minLength: 1 maxLength: 1024 description: City. subdivision: type: string minLength: 1 maxLength: 3 description: ISO 3166-2 state or province code. Required for US addresses. postal_code: type: string minLength: 1 maxLength: 1024 description: Postal code. Required for countries that use them. country: type: string minLength: 3 maxLength: 3 description: ISO 3166-1 alpha-3 country code. required: - street_line_1 - city - country additionalProperties: false description: A postal address used in KYC and KYB data submission. title: VerificationAddress x-stainless-model: fiat.verification_address KybPubliclyTradedListing: type: object properties: market_identifier_code: type: string minLength: 4 maxLength: 4 description: ISO 10383 market identifier code of the listing venue. stock_number: type: string minLength: 1 maxLength: 1024 description: ISIN with dashes removed. ticker: type: string minLength: 1 maxLength: 1024 description: Exchange ticker symbol. required: - market_identifier_code - stock_number - ticker additionalProperties: false description: A public exchange listing for the business. title: KybPubliclyTradedListing x-stainless-model: fiat.kyb_publicly_traded_listing KybAssociatedPerson: type: object properties: first_name: type: string minLength: 1 maxLength: 1024 description: Legal first name. middle_name: type: string minLength: 1 maxLength: 1024 description: Legal middle name. last_name: type: string minLength: 2 maxLength: 1024 description: Legal last name. transliterated_first_name: type: string minLength: 1 maxLength: 256 description: >- Latin-1 transliteration of the first name. Required for non-Latin-1 names. transliterated_middle_name: type: string minLength: 1 maxLength: 256 description: >- Latin-1 transliteration of the middle name. Required for non-Latin-1 names. transliterated_last_name: type: string minLength: 1 maxLength: 256 description: >- Latin-1 transliteration of the last name. Required for non-Latin-1 names. email: type: string maxLength: 1024 format: email description: Email address. phone: type: string maxLength: 1024 description: Phone number in E.164 format. date_of_birth: type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: Date of birth in YYYY-MM-DD format. Must be 18 years or older. residential_address: $ref: '#/components/schemas/VerificationAddress' transliterated_residential_address: $ref: '#/components/schemas/VerificationAddress' identifying_information: type: array items: $ref: '#/components/schemas/VerificationDocument' minItems: 1 maxItems: 1000 description: Identifying documents for this person. has_ownership: type: boolean description: Whether this person owns 25% or more of the business. has_control: type: boolean description: Whether this person is a control person. is_signer: type: boolean description: Whether this person is a signer for the business. is_director: type: boolean description: Whether this person is a director. title: type: string minLength: 1 maxLength: 1024 description: Job title. Required when has_control is true. ownership_percentage: type: integer minimum: 0 maximum: 100 description: Percentage of the business this person owns. nationalities: type: array items: type: string minLength: 3 maxLength: 3 maxItems: 1000 description: ISO 3166-1 alpha-3 codes for all nationalities held. place_of_birth: $ref: '#/components/schemas/KybPlaceOfBirth' relationship_established_at: type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: >- Date the relationship with the business was established, in YYYY-MM-DD format. documents: type: array items: $ref: '#/components/schemas/KybIndividualDocument' maxItems: 1000 description: Supporting documents for this person, such as proof of address. required: - first_name - last_name - email - date_of_birth - residential_address - identifying_information - has_ownership - has_control - is_signer additionalProperties: false description: >- A beneficial owner, control person, or signer associated with the business. At least one of has_ownership, has_control, or is_signer must be true, and the business must have at least one control person and one signer. title: KybAssociatedPerson x-stainless-model: fiat.kyb_associated_person KybEstimatedAnnualRevenue: type: string minLength: 1 maxLength: 64 description: >- Estimated annual revenue of the business, in USD buckets. Passthrough to the provider. See the [Bridge customer API reference](https://apidocs.bridge.xyz/platform/customers/customers/api) for accepted values. title: KybEstimatedAnnualRevenue example: 1000000_9999999 x-stainless-model: fiat.kyb_estimated_annual_revenue KybSourceOfFunds: type: string minLength: 1 maxLength: 128 description: >- Primary source of the funds the business will transact with. Passthrough to the provider. See the [Bridge customer API reference](https://apidocs.bridge.xyz/platform/customers/customers/api) for accepted values. title: KybSourceOfFunds example: sales_of_goods_and_services x-stainless-model: fiat.kyb_source_of_funds KybAccountPurpose: type: string minLength: 1 maxLength: 128 description: >- Primary purpose the business will use the account for. Passthrough to the provider. See the [Bridge customer API reference](https://apidocs.bridge.xyz/platform/customers/customers/api) for accepted values. title: KybAccountPurpose example: treasury_management x-stainless-model: fiat.kyb_account_purpose KybHighRiskActivity: type: string minLength: 1 maxLength: 128 description: >- A high-risk activity the business engages in. Passthrough to the provider. See the [Bridge customer API reference](https://apidocs.bridge.xyz/platform/customers/customers/api) for accepted values. title: KybHighRiskActivity example: none_of_the_above x-stainless-model: fiat.kyb_high_risk_activity KybRegulatedActivity: type: object properties: regulated_activities_description: type: string minLength: 1 maxLength: 1024 description: Description of the regulated activities performed. primary_regulatory_authority_country: type: string minLength: 3 maxLength: 3 description: ISO 3166-1 alpha-3 country code of the primary regulator. primary_regulatory_authority_name: type: string minLength: 1 maxLength: 1024 description: Name of the primary regulator. license_number: type: string minLength: 1 maxLength: 1024 description: License number issued by the regulator. required: - regulated_activities_description - primary_regulatory_authority_country - primary_regulatory_authority_name - license_number additionalProperties: false description: Details of the regulated activity a business is licensed to perform. title: KybRegulatedActivity x-stainless-model: fiat.kyb_regulated_activity VerificationDocument: type: object properties: type: type: string maxLength: 1024 description: Document type identifier. issuing_country: type: string minLength: 3 maxLength: 3 description: ISO 3166-1 alpha-3 issuing country code. number: type: string maxLength: 1024 description: Document number. description: type: string maxLength: 1024 description: Document description. expiration: type: string maxLength: 1024 description: Document expiration date. image_front: type: string maxLength: 34952664 description: Base64-encoded front image. image_back: type: string maxLength: 34952664 description: Base64-encoded back image. required: - type - issuing_country additionalProperties: false description: >- An identifying document for KYC or KYB verification. Also used for business identifiers such as tax and registration numbers, for which the image and expiration fields do not apply. title: VerificationDocument x-stainless-model: fiat.verification_document KybBusinessDocument: type: object properties: purposes: type: array items: $ref: '#/components/schemas/KybDocumentPurpose' minItems: 1 maxItems: 1000 description: What this document evidences. Supports multiple purposes per file. file: type: string minLength: 1 maxLength: 34952664 description: Base64-encoded data URI of the document. description: type: string minLength: 1 maxLength: 1024 description: Document description. Required when "other" is one of the purposes. required: - purposes - file additionalProperties: false description: A supporting document for business verification. title: KybBusinessDocument x-stainless-model: fiat.kyb_business_document KyxTosStatus: type: string description: Status of Terms of Service acceptance. Passthrough from the provider. title: KyxTosStatus example: approved x-stainless-model: fiat.kyx_tos_status KyxEndorsementStatus: type: string description: Status of an endorsement. Passthrough from the provider. title: KyxEndorsementStatus example: approved x-stainless-model: fiat.kyx_endorsement_status KyxCapabilityStatus: type: string description: Status of a capability. Passthrough from the provider. title: KyxCapabilityStatus example: active x-stainless-model: fiat.kyx_capability_status KyxVerificationStatus: type: string description: Status of KYC/KYB verification. Passthrough from the provider. title: KyxVerificationStatus example: approved x-stainless-model: fiat.kyx_verification_status KybPlaceOfBirth: type: object properties: country: type: string minLength: 3 maxLength: 3 description: ISO 3166-1 alpha-3 country code. city: type: string minLength: 1 maxLength: 1024 description: City of birth. required: - country additionalProperties: false description: Place of birth for an associated person. title: KybPlaceOfBirth x-stainless-model: fiat.kyb_place_of_birth KybIndividualDocument: type: object properties: purposes: type: array items: $ref: '#/components/schemas/KybIndividualDocumentPurpose' minItems: 1 maxItems: 1000 description: What this document evidences. Supports multiple purposes per file. file: type: string minLength: 1 maxLength: 34952664 description: Base64-encoded data URI of the document. description: type: string minLength: 1 maxLength: 1024 description: Document description. Required when "other" is one of the purposes. required: - purposes - file additionalProperties: false description: A supporting document for an associated person. title: KybIndividualDocument x-stainless-model: fiat.kyb_individual_document KybDocumentPurpose: type: string minLength: 1 maxLength: 128 description: >- What a supporting business document evidences. Passthrough to the provider. See the [Bridge customer API reference](https://apidocs.bridge.xyz/platform/customers/customers/api) for accepted values. title: KybDocumentPurpose example: business_formation x-stainless-model: fiat.kyb_document_purpose KybIndividualDocumentPurpose: type: string minLength: 1 maxLength: 128 description: >- What a supporting document for an associated person evidences. Passthrough to the provider. See the [Bridge customer API reference](https://apidocs.bridge.xyz/platform/customers/customers/api) for accepted values. title: KybIndividualDocumentPurpose example: proof_of_address x-stainless-model: fiat.kyb_individual_document_purpose securitySchemes: appSecretAuth: type: http scheme: basic description: >- Basic Auth header with your app ID as the username and your app secret as the password. ````