@privy-io/api-types 0.22.0 → 0.24.0

package/src/resources/fiat.ts

@@ -23,6 +23,12 @@ export interface BridgeCreateExternalFiatAccountRequestBody {
    */
   provider: 'bridge';
 
+  /**
+   * The individual or business that owns the account. Required for `iban`, `gb`, and
+   * `swift` accounts.
+   */
+  account_owner?: ExternalFiatAccountOwner;
+
   /**
    * Physical address associated with an external fiat account.
    */
@@ -55,6 +61,12 @@ export interface BridgeCreateFiatDepositAccountRequestBody {
    */
   source: CreateFiatDepositAccountSource;
 
+  /**
+   * A developer fee as a percentage string from 0 up to (not including) 100, e.g.
+   * "1.5" for 1.5%.
+   */
+  developer_fee_percent?: DeveloperFeePercent;
+
   /**
    * The Privy API environment.
    */
@@ -111,6 +123,12 @@ export interface BridgeFiatDepositAccount {
    */
   destination: FiatDepositAccountDestination;
 
+  /**
+   * A developer fee as a percentage string from 0 up to (not including) 100, e.g.
+   * "1.5" for 1.5%.
+   */
+  developer_fee_percent: DeveloperFeePercent;
+
   /**
    * The Privy API environment.
    */
@@ -183,6 +201,12 @@ export interface CreateExternalFiatAccountRequestBody {
    */
   provider: 'bridge';
 
+  /**
+   * The individual or business that owns the account. Required for `iban`, `gb`, and
+   * `swift` accounts.
+   */
+  account_owner?: ExternalFiatAccountOwner;
+
   /**
    * Physical address associated with an external fiat account.
    */
@@ -215,6 +239,12 @@ export interface CreateFiatDepositAccountRequestBody {
    */
   source: CreateFiatDepositAccountSource;
 
+  /**
+   * A developer fee as a percentage string from 0 up to (not including) 100, e.g.
+   * "1.5" for 1.5%.
+   */
+  developer_fee_percent?: DeveloperFeePercent;
+
   /**
    * The Privy API environment.
    */
@@ -241,8 +271,20 @@ export interface CreatePayoutRequestBody {
    * The source crypto asset, chain, and amount for a payout.
    */
   source: PayoutSource;
+
+  /**
+   * A developer fee as a percentage string from 0 up to (not including) 100, e.g.
+   * "1.5" for 1.5%.
+   */
+  developer_fee_percent?: DeveloperFeePercent;
 }
 
+/**
+ * A developer fee as a percentage string from 0 up to (not including) 100, e.g.
+ * "1.5" for 1.5%.
+ */
+export type DeveloperFeePercent = string;
+
 /**
  * A Bridge external fiat account linked to a user.
  */
@@ -291,6 +333,15 @@ export interface ExternalFiatAccountAddress {
   street_line_2?: string;
 }
 
+/**
+ * A business that owns an external fiat account.
+ */
+export interface ExternalFiatAccountBusinessOwner {
+  business_name: string;
+
+  type: 'business';
+}
+
 /**
  * Bank account details. The `type` field discriminates which shape applies.
  */
@@ -341,6 +392,23 @@ export interface ExternalFiatAccountIbanData {
   type: 'iban';
 }
 
+/**
+ * An individual who owns an external fiat account.
+ */
+export interface ExternalFiatAccountIndividualOwner {
+  first_name: string;
+
+  last_name: string;
+
+  type: 'individual';
+}
+
+/**
+ * The individual or business that owns the account. Required for `iban`, `gb`, and
+ * `swift` accounts.
+ */
+export type ExternalFiatAccountOwner = ExternalFiatAccountIndividualOwner | ExternalFiatAccountBusinessOwner;
+
 /**
  * Brazilian Pix account data for an external fiat account. Provide exactly one of
  * `pix_key` or `br_code`.
@@ -454,6 +522,12 @@ export interface FiatDepositAccount {
    */
   destination: FiatDepositAccountDestination;
 
+  /**
+   * A developer fee as a percentage string from 0 up to (not including) 100, e.g.
+   * "1.5" for 1.5%.
+   */
+  developer_fee_percent: DeveloperFeePercent;
+
   /**
    * The Privy API environment.
    */
@@ -560,187 +634,268 @@ export interface FiatDepositInstructions {
 export type FiatPaymentRail = 'sepa' | 'ach_push' | 'wire' | 'fednow' | 'faster_payments';
 
 /**
- * Request body for initiating a hosted KYB flow for an organization.
+ * 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.
  */
-export interface KYBLinksRequestBody {
+export type KYBAccountPurpose = string;
+
+/**
+ * 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.
+ */
+export interface KYBAssociatedPerson {
   /**
-   * Email address for the organization.
+   * Date of birth in YYYY-MM-DD format. Must be 18 years or older.
+   */
+  date_of_birth: string;
+
+  /**
+   * Email address.
    */
   email: string;
 
   /**
-   * KYC/KYB provider identifier.
+   * Legal first name.
    */
-  provider: KyxProvider;
+  first_name: string;
 
   /**
-   * Legal name of the business.
+   * Whether this person is a control person.
    */
-  business_name?: string;
+  has_control: boolean;
 
   /**
-   * Client-side agreement ID for ToS acceptance.
+   * Whether this person owns 25% or more of the business.
    */
-  client_agreement_id?: string;
+  has_ownership: boolean;
 
   /**
-   * Endorsements to request during KYB.
+   * Identifying documents for this person.
    */
-  endorsements?: Array<KyxEndorsementName>;
+  identifying_information: Array<VerificationDocument>;
 
   /**
-   * Provider environment (production or sandbox).
+   * Whether this person is a signer for the business.
    */
-  environment?: KyxEnvironment;
+  is_signer: boolean;
 
   /**
-   * URI to redirect after completing KYB.
+   * Legal last name.
    */
-  redirect_uri?: string;
-}
+  last_name: string;
 
-/**
- * List of KYB status snapshots, one per configured provider/environment.
- */
-export interface KYBStatusListResponse {
-  kyb_statuses: Array<KYBStatusResponse>;
+  /**
+   * A postal address used in KYC and KYB data submission.
+   */
+  residential_address: VerificationAddress;
 
-  next_cursor: string | null;
-}
+  /**
+   * When this person (a control person) attested to having verified the business
+   * ownership structure (ISO 8601).
+   */
+  attested_ownership_structure_at?: (string & {}) | (string & {});
 
-/**
- * Full KYB status for an organization with a given provider.
- */
-export interface KYBStatusResponse {
   /**
-   * Capability statuses for the customer.
+   * Supporting documents for this person, such as proof of address.
    */
-  capabilities: KyxCapabilities;
+  documents?: Array<KYBIndividualDocument>;
 
-  endorsements: Array<KyxEndorsement>;
+  /**
+   * Whether this person is a director.
+   */
+  is_director?: boolean;
 
   /**
-   * Provider environment (production or sandbox).
+   * Result of a KYC/AML or OFAC screen you performed and are relying on the provider
+   * to accept, honoured only for developers enrolled in reliance.
    */
-  environment: KyxEnvironment;
+  kyc_screen?: KyxScreen;
 
   /**
-   * Items that will be required in the future.
+   * Legal middle name.
    */
-  future_requirements_due: Array<string>;
+  middle_name?: string;
 
   /**
-   * Verification status detail for a KYC or KYB check.
+   * ISO 3166-1 alpha-3 codes for all nationalities held.
    */
-  kyb: KyxVerificationStatusDetail;
+  nationalities?: Array<string>;
 
   /**
-   * KYC/KYB provider identifier.
+   * Result of a KYC/AML or OFAC screen you performed and are relying on the provider
+   * to accept, honoured only for developers enrolled in reliance.
    */
-  provider: KyxProvider;
+  ofac_screen?: KyxScreen;
 
   /**
-   * Top-level items still needed (e.g. link a bank account).
+   * Percentage of the business this person owns.
    */
-  requirements_due: Array<string>;
+  ownership_percentage?: number;
 
   /**
-   * KYC/KYB status for the user.
+   * Phone number in E.164 format.
    */
-  status: KyxProviderStatus;
+  phone?: string;
 
   /**
-   * Terms of Service acceptance status for a KYC or KYB flow.
+   * Place of birth for an associated person.
    */
-  tos: KyxTosStatusDetail;
-}
+  place_of_birth?: KYBPlaceOfBirth;
 
-/**
- * Request body for initiating Terms of Service acceptance for an organization.
- */
-export interface KYBTosRequestBody {
   /**
-   * Email address for the organization.
+   * Date the relationship with the business was established, in YYYY-MM-DD format.
    */
-  email: string;
+  relationship_established_at?: string;
 
   /**
-   * KYC/KYB provider identifier.
+   * Job title. Required when has_control is true.
    */
-  provider: KyxProvider;
+  title?: string;
 
   /**
-   * Legal name of the business.
+   * Latin-1 transliteration of the first name. Required for non-Latin-1 names.
    */
-  business_name?: string;
+  transliterated_first_name?: string;
 
   /**
-   * Provider environment (production or sandbox).
+   * Latin-1 transliteration of the last name. Required for non-Latin-1 names.
    */
-  environment?: KyxEnvironment;
+  transliterated_last_name?: string;
+
+  /**
+   * Latin-1 transliteration of the middle name. Required for non-Latin-1 names.
+   */
+  transliterated_middle_name?: string;
+
+  /**
+   * A postal address used in KYC and KYB data submission.
+   */
+  transliterated_residential_address?: VerificationAddress;
+
+  /**
+   * When you verified this person against a database source (ISO 8601).
+   */
+  verified_database_at?: (string & {}) | (string & {});
+
+  /**
+   * When you verified the government ID for this person (ISO 8601).
+   */
+  verified_govid_at?: (string & {}) | (string & {});
+
+  /**
+   * When you verified proof of address for this person (ISO 8601).
+   */
+  verified_proof_of_address_at?: (string & {}) | (string & {});
 }
 
 /**
- * An identity document for KYC verification.
+ * A supporting document for business verification.
  */
-export interface KYCIdentifyingDocument {
+export interface KYBBusinessDocument {
   /**
-   * ISO 3166-1 alpha-3 issuing country code.
+   * Base64-encoded data URI of the document.
    */
-  issuing_country: string;
+  file: string;
 
   /**
-   * Document type identifier.
+   * What this document evidences. Supports multiple purposes per file.
    */
-  type: string;
+  purposes: Array<KYBDocumentPurpose>;
 
   /**
-   * Document description.
+   * Document description. Required when "other" is one of the purposes.
    */
   description?: string;
+}
 
-  /**
-   * Document expiration date.
-   */
-  expiration?: string;
+/**
+ * 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.
+ */
+export type KYBBusinessType = string;
 
+/**
+ * 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.
+ */
+export type KYBDocumentPurpose = string;
+
+/**
+ * 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.
+ */
+export type KYBEstimatedAnnualRevenue = string;
+
+/**
+ * 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.
+ */
+export type KYBHighRiskActivity = string;
+
+/**
+ * A supporting document for an associated person.
+ */
+export interface KYBIndividualDocument {
   /**
-   * Base64-encoded back image.
+   * Base64-encoded data URI of the document.
    */
-  image_back?: string;
+  file: string;
 
   /**
-   * Base64-encoded front image.
+   * What this document evidences. Supports multiple purposes per file.
    */
-  image_front?: string;
+  purposes: Array<KYBIndividualDocumentPurpose>;
 
   /**
-   * Document number.
+   * Document description. Required when "other" is one of the purposes.
    */
-  number?: string;
+  description?: string;
 }
 
 /**
- * Request body for initiating a hosted KYC flow.
+ * 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.
  */
-export interface KYCLinksRequestBody {
+export type KYBIndividualDocumentPurpose = string;
+
+/**
+ * Request body for initiating a hosted KYB flow for an organization.
+ */
+export interface KYBLinksRequestBody {
+  /**
+   * Email address for the organization.
+   */
+  email: string;
+
   /**
    * KYC/KYB provider identifier.
    */
   provider: KyxProvider;
 
   /**
-   * Client-side agreement ID for ToS acceptance.
+   * Legal name of the business.
    */
-  client_agreement_id?: string;
+  business_name?: string;
 
   /**
-   * Email address for the KYC session.
+   * Client-side agreement ID for ToS acceptance.
    */
-  email?: string;
+  client_agreement_id?: string;
 
   /**
-   * Endorsements to request during KYC.
+   * Endorsements to request during KYB.
    */
   endorsements?: Array<KyxEndorsementName>;
 
@@ -750,59 +905,92 @@ export interface KYCLinksRequestBody {
   environment?: KyxEnvironment;
 
   /**
-   * URI to redirect the user after completing KYC.
+   * URI to redirect after completing KYB.
    */
   redirect_uri?: string;
 }
 
 /**
- * Residential address for KYC data submission.
+ * Place of birth for an associated person.
  */
-export interface KYCResidentialAddress {
+export interface KYBPlaceOfBirth {
   /**
-   * City.
+   * ISO 3166-1 alpha-3 country code.
    */
-  city: string;
+  country: string;
 
   /**
-   * ISO 3166-1 alpha-3 country code.
+   * City of birth.
    */
-  country: string;
+  city?: string;
+}
 
+/**
+ * A public exchange listing for the business.
+ */
+export interface KYBPubliclyTradedListing {
   /**
-   * Street address line 1.
+   * ISO 10383 market identifier code of the listing venue.
    */
-  street_line_1: string;
+  market_identifier_code: string;
 
   /**
-   * State or province code.
+   * ISIN with dashes removed.
    */
-  subdivision: string;
+  stock_number: string;
 
   /**
-   * Postal code.
+   * Exchange ticker symbol.
    */
-  postal_code?: string;
+  ticker: string;
+}
+
+/**
+ * Details of the regulated activity a business is licensed to perform.
+ */
+export interface KYBRegulatedActivity {
+  /**
+   * License number issued by the regulator.
+   */
+  license_number: string;
 
   /**
-   * Street address line 2.
+   * ISO 3166-1 alpha-3 country code of the primary regulator.
    */
-  street_line_2?: string;
+  primary_regulatory_authority_country: string;
+
+  /**
+   * Name of the primary regulator.
+   */
+  primary_regulatory_authority_name: string;
+
+  /**
+   * Description of the regulated activities performed.
+   */
+  regulated_activities_description: string;
 }
 
 /**
- * List of KYC status snapshots, one per configured provider/environment.
+ * 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.
  */
-export interface KYCStatusListResponse {
-  kyc_statuses: Array<KYCStatusResponse>;
+export type KYBSourceOfFunds = string;
+
+/**
+ * List of KYB status snapshots, one per configured provider/environment.
+ */
+export interface KYBStatusListResponse {
+  kyb_statuses: Array<KYBStatusResponse>;
 
   next_cursor: string | null;
 }
 
 /**
- * Full KYC status for a user with a given provider.
+ * Full KYB status for an organization with a given provider.
  */
-export interface KYCStatusResponse {
+export interface KYBStatusResponse {
   /**
    * Capability statuses for the customer.
    */
@@ -823,7 +1011,7 @@ export interface KYCStatusResponse {
   /**
    * Verification status detail for a KYC or KYB check.
    */
-  kyc: KyxVerificationStatusDetail;
+  kyb: KyxVerificationStatusDetail;
 
   /**
    * KYC/KYB provider identifier.
@@ -847,74 +1035,544 @@ export interface KYCStatusResponse {
 }
 
 /**
- * KYC verification data for headless submission.
+ * 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.
  */
-export interface KYCSubmitData {
+export interface KYBSubmitData {
   /**
-   * Date of birth in YYYY-MM-DD format.
+   * 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.
    */
-  date_of_birth: string;
+  account_purpose?: KYBAccountPurpose;
 
   /**
-   * Legal first name.
+   * Free-text purpose. Required when account_purpose is "other".
    */
-  first_name: string;
+  account_purpose_other?: string;
 
   /**
-   * Identifying documents.
+   * Whether the business moves funds on behalf of third parties.
    */
-  identifying_information: Array<KYCIdentifyingDocument>;
+  acting_as_intermediary?: boolean;
 
   /**
-   * Legal last name.
+   * Beneficial owners, control persons, and signers.
    */
-  last_name: string;
+  associated_persons?: Array<KYBAssociatedPerson>;
 
   /**
-   * Residential address for KYC data submission.
+   * Short summary of what the business does.
    */
-  residential_address: KYCResidentialAddress;
+  business_description?: string;
 
   /**
-   * Email address.
+   * 2022 NAICS codes describing the industries the business operates in.
    */
-  email?: string;
+  business_industry?: Array<string>;
 
   /**
-   * Phone number in E.164 format.
+   * Registered legal name as filed with government authorities.
    */
-  phone?: string;
-}
+  business_legal_name?: string;
 
-/**
- * Request body for headless KYC data submission.
- */
-export interface KYCSubmitRequestBody {
   /**
-   * KYC verification data for headless submission.
+   * Public trading name (DBA), if different from the legal name.
    */
-  data: KYCSubmitData;
+  business_trade_name?: string;
 
   /**
-   * KYC/KYB provider identifier.
+   * 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.
    */
-  provider: KyxProvider;
+  business_type?: KYBBusinessType;
 
   /**
-   * Client-side agreement ID for ToS acceptance.
+   * Description of the AML and sanctions screening controls in place.
    */
-  client_agreement_id?: string;
+  compliance_screening_explanation?: string;
 
   /**
-   * Endorsements to request during KYC.
+   * Whether the business conducts money services.
    */
-  endorsements?: Array<KyxEndorsementName>;
+  conducts_money_services?: boolean;
 
   /**
-   * Provider environment (production or sandbox).
+   * Description of the money services conducted.
    */
-  environment?: KyxEnvironment;
-}
+  conducts_money_services_description?: string;
+
+  /**
+   * Whether money services are conducted through the provider. Requires a
+   * flow_of_funds document when true.
+   */
+  conducts_money_services_using_bridge?: boolean;
+
+  /**
+   * Supporting documents for verification.
+   */
+  documents?: Array<KYBBusinessDocument>;
+
+  /**
+   * Primary business email address.
+   */
+  email?: string;
+
+  /**
+   * 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.
+   */
+  estimated_annual_revenue_usd?: KYBEstimatedAnnualRevenue;
+
+  /**
+   * Expected monthly payment volume in USD. Required for high-risk businesses.
+   */
+  expected_monthly_payments_usd?: number;
+
+  /**
+   * Whether the business is tax-registered outside its country of incorporation.
+   */
+  has_foreign_tax_registration?: boolean;
+
+  /**
+   * Whether an intermediate entity owner holds 25% or more of the business.
+   */
+  has_material_intermediary_ownership?: boolean;
+
+  /**
+   * High-risk activities the business engages in.
+   */
+  high_risk_activities?: Array<KYBHighRiskActivity>;
+
+  /**
+   * Explanation of the high-risk activities. Required unless the only value is
+   * "none_of_the_above".
+   */
+  high_risk_activities_explanation?: string;
+
+  /**
+   * Business tax and registration identifiers.
+   */
+  identifying_information?: Array<VerificationDocument>;
+
+  /**
+   * Date of incorporation in YYYY-MM-DD format.
+   */
+  incorporation_date?: string;
+
+  /**
+   * Whether the business is a decentralized autonomous organization.
+   */
+  is_dao?: boolean;
+
+  /**
+   * Result of a KYC/AML or OFAC screen you performed and are relying on the provider
+   * to accept, honoured only for developers enrolled in reliance.
+   */
+  kyb_screen?: KyxScreen;
+
+  /**
+   * Result of a KYC/AML or OFAC screen you performed and are relying on the provider
+   * to accept, honoured only for developers enrolled in reliance.
+   */
+  ofac_screen?: KyxScreen;
+
+  /**
+   * Whether the business operates in prohibited jurisdictions.
+   */
+  operates_in_prohibited_countries?: boolean;
+
+  /**
+   * Additional websites and social handles.
+   */
+  other_websites?: Array<string>;
+
+  /**
+   * Ownership percentage at which a person is treated as a beneficial owner.
+   */
+  ownership_threshold?: number;
+
+  /**
+   * Business phone number in E.164 format.
+   */
+  phone?: string;
+
+  /**
+   * A postal address used in KYC and KYB data submission.
+   */
+  physical_address?: VerificationAddress;
+
+  /**
+   * Primary website. If omitted, a proof_of_nature_of_business document is required.
+   */
+  primary_website?: string;
+
+  /**
+   * Public exchange listings for the business.
+   */
+  publicly_traded_listings?: Array<KYBPubliclyTradedListing>;
+
+  /**
+   * A postal address used in KYC and KYB data submission.
+   */
+  registered_address?: VerificationAddress;
+
+  /**
+   * Details of the regulated activity a business is licensed to perform.
+   */
+  regulated_activity?: KYBRegulatedActivity;
+
+  /**
+   * 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.
+   */
+  source_of_funds?: KYBSourceOfFunds;
+
+  /**
+   * Free-text detail on the source of funds. Required for high-risk businesses.
+   */
+  source_of_funds_description?: string;
+
+  /**
+   * Latin-1 transliteration of the legal name. Required for non-Latin-1 names.
+   */
+  transliterated_business_legal_name?: string;
+
+  /**
+   * Latin-1 transliteration of the trade name. Required for non-Latin-1 names.
+   */
+  transliterated_business_trade_name?: string;
+
+  /**
+   * A postal address used in KYC and KYB data submission.
+   */
+  transliterated_physical_address?: VerificationAddress;
+
+  /**
+   * A postal address used in KYC and KYB data submission.
+   */
+  transliterated_registered_address?: VerificationAddress;
+
+  /**
+   * When you verified the business against a database source (ISO 8601).
+   */
+  verified_database_at?: (string & {}) | (string & {});
+
+  /**
+   * When you verified the business registration documents (ISO 8601).
+   */
+  verified_govid_at?: (string & {}) | (string & {});
+
+  /**
+   * When you verified the business proof of address (ISO 8601), required for EEA
+   * customers and SEPA rails under reliance.
+   */
+  verified_proof_of_address_at?: (string & {}) | (string & {});
+}
+
+/**
+ * Request body for headless KYB data submission.
+ */
+export interface KYBSubmitRequestBody {
+  /**
+   * 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.
+   */
+  data: KYBSubmitData;
+
+  /**
+   * KYC/KYB provider identifier.
+   */
+  provider: KyxProvider;
+
+  /**
+   * Client-side agreement ID for ToS acceptance.
+   */
+  client_agreement_id?: string;
+
+  /**
+   * Endorsements to request during KYB.
+   */
+  endorsements?: Array<KyxEndorsementName>;
+
+  /**
+   * Provider environment (production or sandbox).
+   */
+  environment?: KyxEnvironment;
+}
+
+/**
+ * Request body for initiating Terms of Service acceptance for an organization.
+ */
+export interface KYBTosRequestBody {
+  /**
+   * Email address for the organization.
+   */
+  email: string;
+
+  /**
+   * KYC/KYB provider identifier.
+   */
+  provider: KyxProvider;
+
+  /**
+   * Legal name of the business.
+   */
+  business_name?: string;
+
+  /**
+   * Provider environment (production or sandbox).
+   */
+  environment?: KyxEnvironment;
+}
+
+/**
+ * Request body for initiating a hosted KYC flow.
+ */
+export interface KYCLinksRequestBody {
+  /**
+   * KYC/KYB provider identifier.
+   */
+  provider: KyxProvider;
+
+  /**
+   * Client-side agreement ID for ToS acceptance.
+   */
+  client_agreement_id?: string;
+
+  /**
+   * Email address for the KYC session.
+   */
+  email?: string;
+
+  /**
+   * Endorsements to request during KYC.
+   */
+  endorsements?: Array<KyxEndorsementName>;
+
+  /**
+   * Provider environment (production or sandbox).
+   */
+  environment?: KyxEnvironment;
+
+  /**
+   * URI to redirect the user after completing KYC.
+   */
+  redirect_uri?: string;
+}
+
+/**
+ * List of KYC status snapshots, one per configured provider/environment.
+ */
+export interface KYCStatusListResponse {
+  kyc_statuses: Array<KYCStatusResponse>;
+
+  next_cursor: string | null;
+}
+
+/**
+ * Full KYC status for a user with a given provider.
+ */
+export interface KYCStatusResponse {
+  /**
+   * Capability statuses for the customer.
+   */
+  capabilities: KyxCapabilities;
+
+  endorsements: Array<KyxEndorsement>;
+
+  /**
+   * Provider environment (production or sandbox).
+   */
+  environment: KyxEnvironment;
+
+  /**
+   * Items that will be required in the future.
+   */
+  future_requirements_due: Array<string>;
+
+  /**
+   * Verification status detail for a KYC or KYB check.
+   */
+  kyc: KyxVerificationStatusDetail;
+
+  /**
+   * KYC/KYB provider identifier.
+   */
+  provider: KyxProvider;
+
+  /**
+   * Top-level items still needed (e.g. link a bank account).
+   */
+  requirements_due: Array<string>;
+
+  /**
+   * KYC/KYB status for the user.
+   */
+  status: KyxProviderStatus;
+
+  /**
+   * Terms of Service acceptance status for a KYC or KYB flow.
+   */
+  tos: KyxTosStatusDetail;
+
+  /**
+   * Stripe Issuing cardholder ID assigned by Bridge for this user.
+   */
+  stripe_cardholder_id?: string;
+}
+
+/**
+ * KYC verification data for headless submission.
+ */
+export interface KYCSubmitData {
+  /**
+   * Date of birth in YYYY-MM-DD format.
+   */
+  date_of_birth?: string;
+
+  /**
+   * Email address.
+   */
+  email?: string;
+
+  /**
+   * Legal first name.
+   */
+  first_name?: string;
+
+  /**
+   * Identifying documents.
+   */
+  identifying_information?: Array<VerificationDocument>;
+
+  /**
+   * Result of a KYC/AML or OFAC screen you performed and are relying on the provider
+   * to accept, honoured only for developers enrolled in reliance.
+   */
+  kyc_screen?: KyxScreen;
+
+  /**
+   * Legal last name.
+   */
+  last_name?: string;
+
+  /**
+   * Legal middle name.
+   */
+  middle_name?: string;
+
+  /**
+   * ISO 3166-1 alpha-3 codes for all nationalities held.
+   */
+  nationalities?: Array<string>;
+
+  /**
+   * Attests the user is a nonresident alien to satisfy identification without a US
+   * tax ID (must be enabled for you).
+   */
+  nonresident_alien_attestation?: boolean;
+
+  /**
+   * Result of a KYC/AML or OFAC screen you performed and are relying on the provider
+   * to accept, honoured only for developers enrolled in reliance.
+   */
+  ofac_screen?: KyxScreen;
+
+  /**
+   * Phone number in E.164 format.
+   */
+  phone?: string;
+
+  /**
+   * A postal address used in KYC and KYB data submission.
+   */
+  residential_address?: VerificationAddress;
+
+  /**
+   * Stripe Link shared data ID that supplies name, date of birth, address, and US
+   * SSN (omit those fields); retrieval errors surface in endorsements[].issues.
+   */
+  stripe_link_shared_data_id?: string;
+
+  /**
+   * Latin-1 transliteration of the first name. Required for non-Latin-1 names.
+   */
+  transliterated_first_name?: string;
+
+  /**
+   * Latin-1 transliteration of the last name. Required for non-Latin-1 names.
+   */
+  transliterated_last_name?: string;
+
+  /**
+   * Latin-1 transliteration of the middle name. Required for non-Latin-1 names.
+   */
+  transliterated_middle_name?: string;
+
+  /**
+   * A postal address used in KYC and KYB data submission.
+   */
+  transliterated_residential_address?: VerificationAddress;
+
+  /**
+   * When you verified the user against a database source (ISO 8601), which loosens
+   * the identifying-document requirement under reliance.
+   */
+  verified_database_at?: (string & {}) | (string & {});
+
+  /**
+   * When you verified the government ID (ISO 8601), which loosens the
+   * identifying-document requirement under reliance.
+   */
+  verified_govid_at?: (string & {}) | (string & {});
+
+  /**
+   * When you verified proof of address (ISO 8601), required for EEA customers and
+   * SEPA rails under reliance.
+   */
+  verified_proof_of_address_at?: (string & {}) | (string & {});
+}
+
+/**
+ * Request body for headless KYC data submission.
+ */
+export interface KYCSubmitRequestBody {
+  /**
+   * KYC verification data for headless submission.
+   */
+  data: KYCSubmitData;
+
+  /**
+   * KYC/KYB provider identifier.
+   */
+  provider: KyxProvider;
+
+  /**
+   * Client-side agreement ID for ToS acceptance.
+   */
+  client_agreement_id?: string;
+
+  /**
+   * Endorsements to request during KYC.
+   */
+  endorsements?: Array<KyxEndorsementName>;
+
+  /**
+   * Provider environment (production or sandbox).
+   */
+  environment?: KyxEnvironment;
+}
 
 /**
  * Capability statuses for the customer.
@@ -950,6 +1608,11 @@ export type KyxCapabilityStatus = string;
  * An endorsement with its approval status and missing requirements.
  */
 export interface KyxEndorsement {
+  /**
+   * Provider issue codes, or null if none.
+   */
+  issues: Array<string> | null;
+
   /**
    * Missing requirements, or null if complete.
    */
@@ -991,6 +1654,27 @@ export type KyxProvider = 'bridge';
  */
 export type KyxProviderStatus = string;
 
+/**
+ * Result of a KYC/AML or OFAC screen you performed and are relying on the provider
+ * to accept, honoured only for developers enrolled in reliance.
+ */
+export interface KyxScreen {
+  /**
+   * Outcome of a screen performed under KYC/KYB reliance.
+   */
+  result: KyxScreenResult;
+
+  /**
+   * When the screen was performed (ISO 8601 date or date-time).
+   */
+  screened_at: (string & {}) | (string & {});
+}
+
+/**
+ * Outcome of a screen performed under KYC/KYB reliance.
+ */
+export type KyxScreenResult = 'passed' | 'failed';
+
 /**
  * Request body for initiating Terms of Service acceptance.
  */
@@ -1303,8 +1987,27 @@ export interface PayoutDestination {
    * The ID of a previously registered external fiat account to pay out to.
    */
   fiat_account_id: string;
+
+  /**
+   * A fiat payment rail a payout can settle over. `ach` is a standard ACH credit to
+   * the destination account.
+   */
+  payment_rail?: PayoutPaymentRail;
 }
 
+/**
+ * A fiat payment rail a payout can settle over. `ach` is a standard ACH credit to
+ * the destination account.
+ */
+export type PayoutPaymentRail =
+  | 'ach'
+  | 'ach_same_day'
+  | 'wire'
+  | 'fednow'
+  | 'sepa'
+  | 'faster_payments'
+  | 'pix';
+
 /**
  * The source crypto asset, chain, and amount for a payout.
  */
@@ -1325,6 +2028,83 @@ export interface PayoutSource {
   chain: string;
 }
 
+/**
+ * A postal address used in KYC and KYB data submission.
+ */
+export interface VerificationAddress {
+  /**
+   * City.
+   */
+  city: string;
+
+  /**
+   * ISO 3166-1 alpha-3 country code.
+   */
+  country: string;
+
+  /**
+   * Street address line 1.
+   */
+  street_line_1: string;
+
+  /**
+   * Postal code. Required for countries that use them.
+   */
+  postal_code?: string;
+
+  /**
+   * Street address line 2.
+   */
+  street_line_2?: string;
+
+  /**
+   * ISO 3166-2 state or province code. Required for US addresses.
+   */
+  subdivision?: string;
+}
+
+/**
+ * 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.
+ */
+export interface VerificationDocument {
+  /**
+   * ISO 3166-1 alpha-3 issuing country code.
+   */
+  issuing_country: string;
+
+  /**
+   * Document type identifier.
+   */
+  type: string;
+
+  /**
+   * Document description.
+   */
+  description?: string;
+
+  /**
+   * Document expiration date.
+   */
+  expiration?: string;
+
+  /**
+   * Base64-encoded back image.
+   */
+  image_back?: string;
+
+  /**
+   * Base64-encoded front image.
+   */
+  image_front?: string;
+
+  /**
+   * Document number.
+   */
+  number?: string;
+}
+
 export declare namespace Fiat {
   export {
     type BridgeCreateExternalFiatAccountRequestBody as BridgeCreateExternalFiatAccountRequestBody,
@@ -1336,11 +2116,15 @@ export declare namespace Fiat {
     type CreateFiatDepositAccountRequestBody as CreateFiatDepositAccountRequestBody,
     type CreateFiatDepositAccountSource as CreateFiatDepositAccountSource,
     type CreatePayoutRequestBody as CreatePayoutRequestBody,
+    type DeveloperFeePercent as DeveloperFeePercent,
     type ExternalFiatAccount as ExternalFiatAccount,
     type ExternalFiatAccountAddress as ExternalFiatAccountAddress,
+    type ExternalFiatAccountBusinessOwner as ExternalFiatAccountBusinessOwner,
     type ExternalFiatAccountData as ExternalFiatAccountData,
     type ExternalFiatAccountGBData as ExternalFiatAccountGBData,
     type ExternalFiatAccountIbanData as ExternalFiatAccountIbanData,
+    type ExternalFiatAccountIndividualOwner as ExternalFiatAccountIndividualOwner,
+    type ExternalFiatAccountOwner as ExternalFiatAccountOwner,
     type ExternalFiatAccountPixData as ExternalFiatAccountPixData,
     type ExternalFiatAccountResponse as ExternalFiatAccountResponse,
     type ExternalFiatAccountSwiftCategory as ExternalFiatAccountSwiftCategory,
@@ -1355,13 +2139,26 @@ export declare namespace Fiat {
     type FiatDepositAccountStatus as FiatDepositAccountStatus,
     type FiatDepositInstructions as FiatDepositInstructions,
     type FiatPaymentRail as FiatPaymentRail,
+    type KYBAccountPurpose as KYBAccountPurpose,
+    type KYBAssociatedPerson as KYBAssociatedPerson,
+    type KYBBusinessDocument as KYBBusinessDocument,
+    type KYBBusinessType as KYBBusinessType,
+    type KYBDocumentPurpose as KYBDocumentPurpose,
+    type KYBEstimatedAnnualRevenue as KYBEstimatedAnnualRevenue,
+    type KYBHighRiskActivity as KYBHighRiskActivity,
+    type KYBIndividualDocument as KYBIndividualDocument,
+    type KYBIndividualDocumentPurpose as KYBIndividualDocumentPurpose,
     type KYBLinksRequestBody as KYBLinksRequestBody,
+    type KYBPlaceOfBirth as KYBPlaceOfBirth,
+    type KYBPubliclyTradedListing as KYBPubliclyTradedListing,
+    type KYBRegulatedActivity as KYBRegulatedActivity,
+    type KYBSourceOfFunds as KYBSourceOfFunds,
     type KYBStatusListResponse as KYBStatusListResponse,
     type KYBStatusResponse as KYBStatusResponse,
+    type KYBSubmitData as KYBSubmitData,
+    type KYBSubmitRequestBody as KYBSubmitRequestBody,
     type KYBTosRequestBody as KYBTosRequestBody,
-    type KYCIdentifyingDocument as KYCIdentifyingDocument,
     type KYCLinksRequestBody as KYCLinksRequestBody,
-    type KYCResidentialAddress as KYCResidentialAddress,
     type KYCStatusListResponse as KYCStatusListResponse,
     type KYCStatusResponse as KYCStatusResponse,
     type KYCSubmitData as KYCSubmitData,
@@ -1374,6 +2171,8 @@ export declare namespace Fiat {
     type KyxEnvironment as KyxEnvironment,
     type KyxProvider as KyxProvider,
     type KyxProviderStatus as KyxProviderStatus,
+    type KyxScreen as KyxScreen,
+    type KyxScreenResult as KyxScreenResult,
     type KyxTosRequestBody as KyxTosRequestBody,
     type KyxTosResponse as KyxTosResponse,
     type KyxTosStatus as KyxTosStatus,
@@ -1395,6 +2194,9 @@ export declare namespace Fiat {
     type OrganizationExternalFiatAccount as OrganizationExternalFiatAccount,
     type OrganizationExternalFiatAccountResponse as OrganizationExternalFiatAccountResponse,
     type PayoutDestination as PayoutDestination,
+    type PayoutPaymentRail as PayoutPaymentRail,
     type PayoutSource as PayoutSource,
+    type VerificationAddress as VerificationAddress,
+    type VerificationDocument as VerificationDocument,
   };
 }