← Cybrid Bank API

Objects

The object shapes referenced by the Cybrid BankAPI endpoints — identical to Cybrid's own schemas.

Asset

typestringrequired

The asset type; one of fiat or crypto.

codestringrequired

The unique code for the asset.

namestringrequired

The name of the asset.

symbolstringrequired

The currency symbol for the asset.

decimalsintegerrequired

The number of decimals for the default unit of the asset.

ActivityLimit

typestring

The type of the limit; one of rolling, daily, weekly, or monthly.

namestring

The name of the limit.

assetstring

The asset code for the limit.

amountinteger

The limit amount for the asset.

intervalinteger

The limit interval in seconds for the asset.

activitiesstring[]

The activities associated with the limit.

sidesstring[]

The sides associated with the limit.

AssetList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

Bank

guidstringrequired

Auto-generated unique identifier for the bank.

organization_guidstringrequired

The organization's identifier.

namestringrequired

The bank's name.

typestringrequired

The bank type; one of sandbox or production.

supported_trading_symbolsstring[]

The bank's list of supported trading symbols.

supported_payout_symbolsobject[]

The bank's list of supported payout symbols.

supported_fiat_account_assetsstring[]

The bank's list of supported fiat symbols.

supported_country_codesstring[]

The bank's list of supported country codes.

featuresstring[]required

The bank's enabled features.

cors_allowed_originsstring[]

The bank's list of CORS allowed origins.

created_atstring<date-time>required

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

BankList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

Counterparty

guidstring

Auto-generated unique identifier for the counterparty.

typestring

The counterparty type; one of business or individual.

bank_guidstring

Auto-generated unique identifier for the counterparty's bank.

customer_guidstring

Auto-generated unique identifier for the counterparty's customer.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

statestring

The counterparty state; one of storing, unverified, verified, or rejected.

nameobject

The counterparty's name. Only available for GET operations when 'include_pii' is set.

firststring

The counterparty's first name.

middlestring

The counterparty's middle name.

laststring

The counterparty's last name.

fullstring

The counterparty's full name.

addressobject

The counterparty's address. Only available for GET operations when 'include_pii' is set.

streetstring

The first line of the address.

street2string

The optional second line of the address.

citystring

The city of the address.

subdivisionstring

The ISO 3166-2 subdivision code of the address; not used by all countries.

postal_codestring

The postal/post/zip code of the address; not used by all countries.

country_codestring

The ISO 3166 country 2-Alpha country code of the address.

aliasesobject[]

The counterparty's aliases. Only available for GET operations when 'include_pii' is set.

date_of_birthstring<date>

The counterparty's DOB. Only available for GET operations when 'include_pii' is set.

labelsstring[]

The labels associated with the counterparty.

compliance_decisionsobject[]

The compliance decisions associated with the counterparty.

CounterpartyList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

Customer

guidstring

Auto-generated unique identifier for the customer.

bank_guidstring

Auto-generated unique identifier for the customer's bank.

typestring

The customer type; one of business or individual.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

statestring

The customer state; one of storing, unverified, verified, rejected, or frozen.

nameobject

The customer's name. Only available for GET operations when 'include_pii' is set.

firststring

The customer's first name.

middlestring

The customer's middle name.

laststring

The customer's last name.

fullstring

The customer's full name.

addressobject

The customer's address. Only available for GET operations when 'include_pii' is set.

streetstring

The first line of the address.

street2string

The optional second line of the address.

citystring

The city of the address.

subdivisionstring

The ISO 3166-2 subdivision code of the address; not used by all countries.

postal_codestring

The postal/post/zip code of the address; not used by all countries.

country_codestring

The ISO 3166 country 2-Alpha country code of the address.

aliasesobject[]

The customer's aliases. Only available for GET operations when 'include_pii' is set.

websitestring

The customer's website. Only available for GET operations when 'include_pii' is set.

date_of_birthstring<date>

The customer's DOB. Only available for GET operations when 'include_pii' is set.

phone_numberstring

The customer's phone number. Only available for GET operations when 'include_pii' is set.

email_addressstring

The customer's email address. Only available for GET operations when 'include_pii' is set.

labelsstring[]

The labels associated with the customer.

compliance_decisionsobject[]

The compliance decisions associated with the customer.

identification_numbersobject[]

The customer's identification numbers. Only available for GET operations when 'include_pii' is set and bank has access.

activity_limitsobject[]

The asset limits associated with the customer.

LegalEntityName

A legal entity name.

firststring

The legal entity's first name.

middlestring

The legal entity's middle name.

laststring

The legal entity's last name.

fullstring

The legal entity's full name.

PhysicalAddress

A physical address.

streetstring

The first line of the address.

street2string

The optional second line of the address.

citystring

The city of the address.

subdivisionstring

The ISO 3166-2 subdivision code of the address; not used by all countries.

postal_codestring

The postal/post/zip code of the address; not used by all countries.

country_codestring

The ISO 3166 country 2-Alpha country code of the address.

CustomerList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

IdentityVerification

guidstring

Auto-generated unique identifier for the identity verification.

typestring

The identity verification type; one of kyc, bank_account, or counterparty.

methodstring

The identity verification method; one of attested, document_submission, enhanced_due_diligence, id_and_selfie, tax_id_and_selfie, business_registration, attested_id_and_selfie, attested_business_registration, attested_business_associate, attested_id_and_database, watchlists, attested_ownership, or account_ownership.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

customer_guidstring

The customer's identifier.

counterparty_guidstring

The counterparty's identifier.

external_bank_account_guidstring

The external bank account's identifier.

statestring

The identity verification state; one of storing, waiting, pending, reviewing, expired, or completed.

outcomestring

The identity verification outcome; one of passed or failed.

failure_codesstring[]

The reason codes explaining the outcome.

compliance_decisionsobject[]

The compliance decisions associated with the identity verification.

optionsobject

Options for the identity verification.

require_tax_idboolean

Whether the tax ID was enforced during identity verification.

IdentityVerificationWithDetails

guidstring

Auto-generated unique identifier for the identity verification.

typestring

The identity verification type; one of kyc, bank_account, or counterparty.

methodstring

The identity verification method; one of attested, document_submission, enhanced_due_diligence, id_and_selfie, tax_id_and_selfie, business_registration, attested_id_and_selfie, attested_business_registration, attested_business_associate, attested_id_and_database, watchlists, attested_ownership, or account_ownership.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

customer_guidstring

The identity verification's identifier.

counterparty_guidstring

The identity verification's identifier.

external_bank_account_guidstring

The identity verification's identifier.

statestring

The identity verification state; one of storing, waiting, pending, reviewing, expired, or completed.

outcomestring

The identity verification outcome; one of passed or failed.

failure_codesstring[]

The reason codes explaining the outcome.

compliance_checksobject[]

The compliance checks associated with the identity verification.

compliance_decisionsobject[]

The compliance decisions associated with the identity verification.

persona_inquiry_idstring

The Persona identifier of the backing inquiry.

persona_statestring

The Persona state of the backing inquiry; one of waiting, pending, reviewing, processing, expired, completed, or unknown.

business_associatesobject[]

List of associates declared for the business customer.

piiobject

The personally identifiable information associated with the identity verification.

nameobject

The attested name

aliasesobject[]

The business attested aliases.

addressobject

The attested address.

date_of_birthstring<date>

The attested date of birth.

phone_numberstring

The attested phone number.

email_addressstring

The attested email address.

occupationstring

The attested occupation.

websitestring

The attested website.

nature_of_businessstring

The attested nature of business.

registered_addressobject

The attested registered address.

business_industrystring

The attested business industry.

business_funds_sourcestring

The attested business funds source.

business_funds_destinationstring

The attested business funds destination.

identification_numbersobject[]

The attested identification numbers.

documentsobject[]

The documents associated with the identity verification.

supporting_filesobject[]

The supporting documents associated with the attested identity verification.

optionsobject

Options for the identity verification.

require_tax_idboolean

Whether the tax ID was enforced during identity verification.

IdentityVerificationDocument

guidstring

Auto-generated unique identifier for the document.

typestring

The document type; one of drivers_license, passport, passport_card, residence_card, visa, social_security_number, tax_identification_number, selfie, proof_of_address, formation_document, employer_identification_number, indigenous_document_number, or work_permit.

validatedboolean

Whether the document has been validated.

expiration_datestring<date>

The document expiration date.

filesobject[]

The files associated with the document.

IdentityVerificationDocumentFile

guidstring

The unique identifier for the file.

typestring

The file type; one of drivers_license_front, drivers_license_back, drivers_license, passport, passport_card, identification_card, residence_card, work_permit, indigenous_id_document, selfie, selfie_video, selfie_left, selfie_right, proof_of_address, or incorporation_certificate.

content_typestring

The media type; one of image/jpeg, image/png, application/pdf, application/json, or video/mp4.

filenamestring

The name of the file.

metadataobject

File metadata (e.g., {"part": "front"})

partfront | back

The part of the file (e.g., "front", "back")

IdentityVerificationBusinessAssociate

persona_inquiry_idstring

The Persona identifier of the business associate backing inquiry. Available only for attested_business_registration verification method

persona_statestring

The Persona state of the backing inquiry; one of waiting, pending, reviewing, processing, expired, completed, or unknown. Available only for attested_business_registration verification method

customer_guidstring

The business associate's customer identifier. Available only for attested_business_registration verification method

rolestring

The business associate role; one of director or owner.

email_addressstring

The business associate email address. Available only for business_registration verification method

statestring

The business associate state; one of completed, waiting, or pending.

IdentityVerificationList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

ComplianceCheck

typestringrequired

The type of compliance check; one of business_watchlists, business_verification, business_tax_id_verification, business_attested, business_tax_id_attested, business_watchlists_attested, person_attested, person_tax_id_attested, person_gov_id_attested, person_authentication_attested, person_watchlists_attested, person_watchlists, person_verification, person_authentication, person_gov_id_verification, person_tax_id_verification, business_associate_gov_id_attested, business_associate_authentication_attested, business_associate_attested, business_associate_tax_id_attested, business_associate_watchlists_attested, external_bank_account_verification, or external_bank_account_attested.

outcomestringrequired

The outcome of the compliance check; one of passed, failed, insufficient, or inconclusive.

failure_codesstring[]

The reason codes explaining the outcome.

ComplianceDecision

typestringrequired

The type of verification check; one of business_watchlists, business_verification, business_tax_id_verification, business_attested, business_tax_id_attested, business_watchlists_attested, person_attested, person_tax_id_attested, person_gov_id_attested, person_authentication_attested, person_watchlists_attested, person_watchlists, person_verification, person_authentication, person_gov_id_verification, person_tax_id_verification, business_associate_gov_id_attested, business_associate_authentication_attested, business_associate_attested, business_associate_tax_id_attested, business_associate_watchlists_attested, external_bank_account_verification, or external_bank_account_attested.

statestringrequired

The state of the verification check; one of passed, failed, expired, or invalidated.

failure_codesstring[]

The reason codes explaining the outcome.

expired_atstring<date-time>

ISO8601 datetime the compliance decision is expired.

PostDepositBankAccount

Request body for deposit bank account creation.

namestring

The name of the deposit bank account.

typemain | sub_accountrequired

The account type. To generate deposit bank accounts with their own unique account number set this to "main". To generate deposit bank accounts with the same account number as the parent deposit bank account set this to "sub_account". This setting will only generate a unique identifier for the deposit bank and will not result in a unique account number being generated. "sub_account" is only available for customer-level deposit bank accounts.

account_guidstringrequired

The fiat or reserve account guid.

customer_guidstring

The unique identifier for the customer.

parent_deposit_bank_account_guidstring

The unique identifier for the bank-level deposit bank account. This is only required for sub-accounts. Required when type is sub_account.

labelsstring[]

The labels associated with the bank account.

PostInvoice

Request body for invoice creation.

assetstringrequired

The asset code the customer will receive the funds in.

customer_guidstring

The unique identifier for the customer.

receive_amountinteger

The amount to be received in base units of the asset, i.e., the amount the customer will receive after fees. ONLY one of receive_amount or deliver_amount is required.

deliver_amountinteger

The amount to be delivered in base units of the asset, i.e., the amount the customer will receive before fees. ONLY one of receive_amount or deliver_amount is required.

account_guidstring

The identifier for the account to use for the transfer. Required if the customer has multiple fiat accounts. Currently only valid for invoices paid to a fiat account.

labelsstring[]

The labels associated with the invoice.

PostPaymentInstruction

Request body for payment instruction creation.

invoice_guidstringrequired

The invoice guid.

expected_behaviourinvoice_paid_immediately

The optional expected behaviour to simulate.

Invoice

guidstring

Auto-generated unique identifier for the payment instruction.

customer_guidstring

The customer identifier.

account_guidstring

The account payment will ultimately be received into.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

typestring

The type of invoice; one of lightning.

assetstring

The asset code the customer will receive the funds in.

receive_amountinteger

The amount to be received in base units of the asset, i.e., the amount the customer will receive after fees. ONLY one of receive_amount or deliver_amount is required.

deliver_amountinteger

The amount to be delivered in base units of the asset, i.e., the amount the customer will receive before fees. ONLY one of receive_amount or deliver_amount is required.

feeinteger

The fee associated with this invoice in base units of the asset.

statestring

The state of the invoice; one of storing, unpaid, cancelling, cancelled, settling, or paid.

labelsstring[]

The labels associated with the invoice.

InvoiceList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

PaymentInstruction

guidstring

Auto-generated unique identifier for the payment instruction.

customer_guidstring

The customer identifier.

invoice_guidstring

The invoice identifier.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

expired_atstring<date-time>

ISO8601 datetime the instructions expired at.

failed_atstring<date-time>

ISO8601 datetime the instructions failed to be created at.

network_addressstring

The network address to pay the invoice to.

expected_payment_assetstring

The asset the payor must pay the invoice in, e.g., BTC.

expected_payment_amountinteger

The amount to be paid in base units of expected_payment_asset.

failure_codestring

The reason code explaining the failure; ond of invoice_paid, invoice_cancelled, or invalid_amount.

statestring

The state of the payment instruction; one of storing, created, expired, or failed.

PaymentInstructionList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

DepositBankAccount

guidstring

Auto-generated unique identifier for the identity verification.

namestring

The name of the deposit bank account.

typestring

The account type; one of main or sub_account.

bank_guidstring

The address' bank identifier.

customer_guidstring

The address' customer identifier.

account_guidstring

The address' account identifier.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

deleted_atstring<date-time>

ISO8601 datetime the record was last deleted at.

assetstring

The asset the transfer is related to, e.g., USD.

statestring

The state of the deposit bank account; one of storing, created, deleting, or deleted.

unique_memo_idstring

The unique memo identifier for the deposit bank account. This is used to identify the recipient when sending funds to the account. This value MUST be included in all wire transfers to this account.

counterparty_namestring

The name of the account holder.

counterparty_addressobject

The counterparty's address on the account.

streetstringrequired

The first line of the address.

street2string

The optional second line of the address.

citystringrequired

The city of the address.

subdivisionstring

The ISO 3166-2 subdivision code of the address; not used by all countries.

postal_codestring

The postal/post/zip code of the address; not used by all countries.

country_codestringrequired

The ISO 3166 country 2-Alpha country code of the address.

account_detailsobject[]

The account details for the bank account.

routing_detailsobject[]

The account details for the bank account.

parent_deposit_bank_account_guidstring

The unique identifier for the bank-level deposit bank account. This is only set for sub-accounts.

labelsstring[]

The labels associated with the address.

DepositBankAccountList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

DepositAddress

guidstring

Auto-generated unique identifier for the identity verification.

namestring

The name of the deposit address.

bank_guidstring

The address' bank identifier.

customer_guidstring

The address' customer identifier.

account_guidstring

The address' account identifier.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

assetstring

The asset the transfer is related to, e.g., USD.

statestring

The state of the address; one of storing or created.

addressstring

The blockchain address.

formatstring

The blockchain address format; one of standard or legacy.

tagstring

The blockchain address tag.

labelsstring[]

The labels associated with the address.

DepositAddressList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

SymbolPrice

symbolstring

The trade symbol the pricing is related to. Format is asset-counter_asset, e.g., BTC-USD.

typestring

The type of price; one of trading or payout.

buy_priceinteger

The purchase price (in base units) for the asset denominated in the counter asset currency.

sell_priceinteger

The sale price (in base units) for the asset denominated in the counter asset currency.

buy_price_last_updated_atstring<date-time>

ISO8601 datetime the purchase price was generated at.

sell_price_last_updated_atstring<date-time>

ISO8601 datetime the sale price was generated at.

country_codestring

The ISO 3166 country 2-Alpha country code of the price.

participants_typestring

The type of participants the price is for; one of C2C, C2B, B2C, or B2B.

routestring

The route the price is for; one of bank_account or mobile_wallet.

PostQuote

Request body for quote creation.

product_typetrading | funding | crypto_transfer | inter_account | lightning_transfer | book_transfer

The type of product the quote is for.

bank_guidstring

The unique identifier for the bank.

customer_guidstring

The unique identifier for the customer.

receive_amountinteger

The amount to be received in base units of the currency: currency is "asset" for buy and "counter_asset" for sell for trade quotes.

deliver_amountinteger

The amount to be delivered in base units of the currency: currency is "counter_asset" for buy and "asset" for sell for trade quotes.

assetstring

The asset code the quote was requested for. Required when product_type is lightning_transfer, product_type is book_transfer, product_type is funding, product_type is crypto_transfer, or product_type is inter_account.

network_addressstring

The network address to pay the invoice to. Required when product_type is lightning_transfer.

feesobject[]

The custom fees associated with the quote Optional when product_type is lightning_transfer, product_type is funding, product_type is trading, product_type is crypto_transfer, or product_type is trading_exit.

sidedeposit | withdrawal | buy | sell

The direction for trade quotes: either 'buy' or 'sell'. The direction for funding quotes: either 'deposit' or 'withdrawal'. The direction for crypto transfer quotes: 'withdrawal'. Book transfers do not require a side. They are all 'deposit's. Required when product_type is funding, product_type is trading, or product_type is crypto_transfer.

destination_account_guidstring

The unique identifier for the destination account. Used to determine routing-specific fees for EFT withdrawals. Required when product_type is inter_account. Optional when product_type is funding.

payment_railach | eft | wire | rtp | etransfer

The payment rail the resulting transfer will execute on. Required when the downstream transfer will be an e-transfer withdrawal. Optional when product_type is funding.

symbolstring

Symbol the quote is being requested for. Format is "asset-counter_asset" in uppercase. See the Symbols API for a complete list of cryptocurrencies supported. Required when product_type is trading.

destination_accountsobject[]

Destination accounts for batch transactions on UTXO-based blockchains. A single destination account is required for Base blockchain assets. Optional when product_type is crypto_transfer.

reference_trade_guidstring

The guid of the related trade. Only present on `exit` trades. Required when product_type is trading_exit.

source_account_guidstring

The source account's identifier. Required when product_type is inter_account.

PostQuoteEntry

Request body for quote account creation.

typeexternal_walletrequired

The type of account

guidstringrequired

The guid of the account

receive_amountinteger

The amount to be received in base units of the currency: currency is "asset" for buy and "counter_asset" for sell for trade quotes.

deliver_amountinteger

The amount to be delivered in base units of the currency: currency is "counter_asset" for buy and "asset" for sell for trade quotes.

PostFee

Request body for fee creation.

typespread | fixedrequired

The fee's type

spread_feeinteger

The percentage amount, in basis points, to apply when charging a fee. Required when type is spread.

fixed_feeinteger

The fixed amount to apply when charging a fee; for trades, the fiat asset is used. Required when type is fixed.

Quote

guidstring

Auto-generated unique identifier for the quote.

product_typestring

The type of product the quote is for; one of trading, trading_exit, funding, crypto_transfer, inter_account, lightning_transfer, or book_transfer.

bank_guidstring

The unique identifier for the bank.

customer_guidstring

The unique identifier for the customer.

symbolstring

Symbol the quote was requested for. Format is "asset-counter_asset" in uppercase. Populated for trade quotes.

sidestring

The direction of the quote; one of buy, sell, deposit, or withdrawal.

receive_amountinteger

The amount to be received in base units of the currency: currency is "asset" for buy and "counter_asset" for sell for trade quotes.

deliver_amountinteger

The amount to be delivered in base units of the currency: currency is "counter_asset" for buy and "asset" for sell for trade quotes.

feeinteger

The fee associated with the trade. Denominated in "counter_asset" base units for trade quotes.

fee_detailsobject[]

The fees associated with the quote.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

issued_atstring<date-time>

ISO8601 datetime the quote was created at.

expires_atstring<date-time>

ISO8601 datetime the quote is expiring at. Populated for trading quotes.

assetstring

The asset code the quote was requested for. Populated for book transfer and funding quotes.

network_feeinteger

The network fee in base units of network_fee_asset. Only present on `crypto_transfer` quotes.

network_fee_assetstring

The asset code of the network fee.

network_addressstring

The network address to pay the invoice to. Populated for lightning_transfer quotes.

entriesobject[]

The quote entries for a batch transfer quote

trade_guidstring

The unique identifier for the trade.

transfer_guidstring

The unique identifier for the transfer.

PostPlan

Request body for plan creation.

typeremittancerequired

The type of product the plan is for.

bank_guidstring

The unique identifier for the bank.

customer_guidstring

The unique identifier for the customer.

source_accountobjectrequired

Source account

guidstringrequired

The source account's identifier.

amountinteger

The amount to be delivered in base units of the source account currency

payment_railach | eft | wire | rtp | etransfer

The desired payment rail to use to initiate a fiat transfer from the source account.

destination_accountobjectrequired

Destination account

guidstringrequired

The destination account's identifier.

amountinteger

The amount to be delivered in base units of the source account currency

payment_railach | eft | wire | rtp | etransfer

The desired payment rail to use to initiate a fiat transfer to the destination account.

travel_rule_infoobject

Travel rule information

ultimate_originating_party_guidstring

The unique identifier for the ultimate originating party.

ultimate_receiving_party_guidstring

The unique identifier for the ultimate receiving party.

purpose_of_transactioncomputer_services | family_support | education | gift | charitable_donation | medical_treatment | maintenance_expenses | travel | hotel_accommodation | small_value_remittance | liberalized_remittance | personal_transfer | loan_payment | tax_payment | construction_expenses | advertising_expenses | advisory_fees | business_insurance | insurance_claims | delivery_fees | service_charges | office_expenses | property_purchase | property_rental | royalty_fees | shares_investment | fund_investment | bill_payment | transportation_fees | salary_payment | reward_payment | influencer_payment | other_fees | other | exported_goods | commission_on_goods | commission_on_services | accounting_services | exhibition_services

The purpose of transaction for the plan.

labelsstring[]

The labels associated with the plan.

supporting_documentsobject[]

Supporting documents to attach to the plan. Optional when type is remittance.

Plan

guidstringrequired

Auto-generated unique identifier for the entity.

typestringrequired

The type of product the plan is for; one of remittance, deposit_return, or withdrawal_return.

bank_guidstring

The unique identifier for the bank.

customer_guidstring

The unique identifier for the customer.

created_atstring<date-time>required

ISO8601 datetime the record was created at.

updated_atstring<date-time>required

ISO8601 datetime the record was last updated at.

expires_atstring<date-time>required

ISO8601 datetime the plan will expire at. Null for return plans, which do not expire.

statestringrequired

The state of the plan; one of storing, planning, completed, or failed.

failure_codestring

The failure code for failed plans.

source_accountobjectrequired
guidstringrequired

Auto-generated unique identifier for the transfer account.

typestringrequired

The type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.

organization_guidstring

The account's organization identifier.

bank_guidstring

The account's bank identifier.

customer_guidstring

The account's customer identifier.

counterparty_guidstring

The account's counterparty identifier.

assetstringrequired

The account asset, e.g., USD.

requested_amountinteger

The requested amount in base units intended to transfer from or to the account.

quoted_amountinteger

The quoted amount in base units to transfer from or to the account.

executed_amountinteger

The executed amount in base units transferred from or to the account.

payment_railach | eft | wire | rtp | etransfer

The desired payment rail to use to initiate a fiat transfer.

destination_accountobjectrequired
guidstringrequired

Auto-generated unique identifier for the transfer account.

typestringrequired

The type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.

organization_guidstring

The account's organization identifier.

bank_guidstring

The account's bank identifier.

customer_guidstring

The account's customer identifier.

counterparty_guidstring

The account's counterparty identifier.

assetstringrequired

The account asset, e.g., USD.

requested_amountinteger

The requested amount in base units intended to transfer from or to the account.

quoted_amountinteger

The quoted amount in base units to transfer from or to the account.

executed_amountinteger

The executed amount in base units transferred from or to the account.

payment_railach | eft | wire | rtp | etransfer

The desired payment rail to use to initiate a fiat transfer.

stagesobject[]required

The stages of the plan.

feesobject[]required

The fees associated with the plan.

travel_rule_infoobjectrequired

The travel rule information associated with the plan.

originating_partyobjectrequired
receiving_partyobjectrequired
ultimate_originating_partyobject
ultimate_receiving_partyobject
purpose_of_transactioncomputer_services | family_support | education | gift | charitable_donation | medical_treatment | maintenance_expenses | travel | hotel_accommodation | small_value_remittance | liberalized_remittance | personal_transfer | loan_payment | tax_payment | construction_expenses | advertising_expenses | advisory_fees | business_insurance | insurance_claims | delivery_fees | service_charges | office_expenses | property_purchase | property_rental | royalty_fees | shares_investment | fund_investment | bill_payment | transportation_fees | salary_payment | reward_payment | influencer_payment | other_fees | other | exported_goods | commission_on_goods | commission_on_services | accounting_services | exhibition_services

The purpose of transaction for the plan.

supporting_documentsobject[]

Supporting documents attached to the plan. Optional when type is remittance.

labelsstring[]

The labels associated with the plan.

PostSupportingDocument

Supporting document attached to a plan.

typeinvoice | purchase_order | delivery_slip | contract | bill_of_lading | othersrequired

The kind of supporting document.

file_guidsstring[]required

File guids backing this document.

document_reference_numberstring

A reference number identifying this document (e.g. an invoice number). Required for payouts to certain corridors.

SupportingDocument

guidstringrequired

Auto-generated unique identifier for the document.

typeinvoice | purchase_order | delivery_slip | contract | bill_of_lading | othersrequired

The kind of supporting document; one of invoice, purchase_order, delivery_slip, contract, bill_of_lading, or others.

filesobject[]required

The files backing this document.

document_reference_numberstring

A reference number identifying this document (e.g. an invoice number).

SupportingDocumentFile

guidstringrequired

Auto-generated unique identifier for the file.

filenamestringrequired

The original filename.

content_typestringrequired

The MIME content type.

PlanList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

PostExecution

Request body for plan creation.

plan_guidstringrequired

The unique identifier for the plan.

sardine_session_guidstring

The GUID of a previously created Sardine session. Used to correlate device signals from the Sardine SDK with the execution screening.

ExecutionList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

Execution

guidstringrequired

Auto-generated unique identifier for the quote.

typestringrequired

The type of product the plan is for; one of remittance, deposit_return, or withdrawal_return.

plan_guidstringrequired

The unique identifier for the plan.

bank_guidstring

The unique identifier for the bank.

customer_guidstring

The unique identifier for the customer.

created_atstring<date-time>required

ISO8601 datetime the record was created at.

updated_atstring<date-time>required

ISO8601 datetime the record was last updated at.

statestringrequired

The state of the execution; one of storing, executing, completed, failed, or reviewing.

failure_codestring

The failure code for failed executions.

source_accountobjectrequired
guidstringrequired

Auto-generated unique identifier for the transfer account.

typestringrequired

The type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.

organization_guidstring

The account's organization identifier.

bank_guidstring

The account's bank identifier.

customer_guidstring

The account's customer identifier.

counterparty_guidstring

The account's counterparty identifier.

assetstringrequired

The account asset, e.g., USD.

requested_amountinteger

The requested amount in base units intended to transfer from or to the account.

quoted_amountinteger

The quoted amount in base units to transfer from or to the account.

executed_amountinteger

The executed amount in base units transferred from or to the account.

payment_railach | eft | wire | rtp | etransfer

The desired payment rail to use to initiate a fiat transfer.

destination_accountobjectrequired
guidstringrequired

Auto-generated unique identifier for the transfer account.

typestringrequired

The type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.

organization_guidstring

The account's organization identifier.

bank_guidstring

The account's bank identifier.

customer_guidstring

The account's customer identifier.

counterparty_guidstring

The account's counterparty identifier.

assetstringrequired

The account asset, e.g., USD.

requested_amountinteger

The requested amount in base units intended to transfer from or to the account.

quoted_amountinteger

The quoted amount in base units to transfer from or to the account.

executed_amountinteger

The executed amount in base units transferred from or to the account.

payment_railach | eft | wire | rtp | etransfer

The desired payment rail to use to initiate a fiat transfer.

stagesobject[]required

The stages of the execution.

feesobject[]required

The fees associated with the execution.

holdsobject[]

The holds placed on the execution.

travel_rule_infoobjectrequired

The travel rule information associated with the execution.

originating_partyobjectrequired
receiving_partyobjectrequired
ultimate_originating_partyobject
ultimate_receiving_partyobject
purpose_of_transactioncomputer_services | family_support | education | gift | charitable_donation | medical_treatment | maintenance_expenses | travel | hotel_accommodation | small_value_remittance | liberalized_remittance | personal_transfer | loan_payment | tax_payment | construction_expenses | advertising_expenses | advisory_fees | business_insurance | insurance_claims | delivery_fees | service_charges | office_expenses | property_purchase | property_rental | royalty_fees | shares_investment | fund_investment | bill_payment | transportation_fees | salary_payment | reward_payment | influencer_payment | other_fees | other | exported_goods | commission_on_goods | commission_on_services | accounting_services | exhibition_services

The purpose of transaction for the execution.

referencesobject[]

Objects this return execution references (the returned execution and stage). Optional when type is deposit_return or type is withdrawal_return.

labelsstring[]

The labels associated with the execution.

PlanReference

typereturned_execution | returned_stagerequired

The type of object being referenced; one of returned_execution or returned_stage.

guidstringrequired

The guid of the referenced object.

Stage

guidstringrequired

The unique identifier for the stage.

typestringrequired

The type of stage; one of payout, deposit, withdrawal, trade, deposit_return, loss_recovery, or withdrawal_return.

statestringrequired

The state of the stage; one of storing, planning, planned, executing, completed, or failed.

failure_codestring

The failure code for failed stages.

identifiersobject[]required

Provider-issued identifiers associated with this stage. Always present, possibly empty.

linksobject[]required

Provider-issued links associated with this stage. Always present, possibly empty.

created_atstring<date-time>required

The ISO8601 datetime the stage was created at.

updated_atstring<date-time>required

The ISO8601 datetime the stage was last updated at.

source_accountobjectrequired
guidstringrequired

Auto-generated unique identifier for the transfer account.

typestringrequired

The type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.

organization_guidstring

The account's organization identifier.

bank_guidstring

The account's bank identifier.

customer_guidstring

The account's customer identifier.

counterparty_guidstring

The account's counterparty identifier.

assetstringrequired

The account asset, e.g., USD.

requested_amountinteger

The requested amount in base units intended to transfer from or to the account.

quoted_amountinteger

The quoted amount in base units to transfer from or to the account.

executed_amountinteger

The executed amount in base units transferred from or to the account.

payment_railach | eft | wire | rtp | etransfer

The desired payment rail to use to initiate a fiat transfer.

destination_accountobjectrequired
guidstringrequired

Auto-generated unique identifier for the transfer account.

typestringrequired

The type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.

organization_guidstring

The account's organization identifier.

bank_guidstring

The account's bank identifier.

customer_guidstring

The account's customer identifier.

counterparty_guidstring

The account's counterparty identifier.

assetstringrequired

The account asset, e.g., USD.

requested_amountinteger

The requested amount in base units intended to transfer from or to the account.

quoted_amountinteger

The quoted amount in base units to transfer from or to the account.

executed_amountinteger

The executed amount in base units transferred from or to the account.

payment_railach | eft | wire | rtp | etransfer

The desired payment rail to use to initiate a fiat transfer.

feesobject[]required

The fees associated with the stage.

deposit_return_detailsobject
returned_atstring<date-time>required

The timestamp when the return was initiated by the provider.

return_codestring

The ACH/EFT return code (e.g. R01, R10) received from the provider. Absent when the provider did not report a return code.

withdrawal_return_detailsobject
returned_atstring<date-time>required

The timestamp when the return was initiated by the provider.

return_codestring

The ACH/EFT return code (e.g. R01, R10) received from the provider. Absent when the provider did not report a return code.

StageIdentifier

typestringrequired

The kind of identifier.

valuestringrequired

The identifier value as issued by the rail.

ReturnDetails

returned_atstring<date-time>required

The timestamp when the return was initiated by the provider.

return_codestring

The ACH/EFT return code (e.g. R01, R10) received from the provider. Absent when the provider did not report a return code.

FeeAssociation

typestringrequired

The type of fee; one of platform, network, or bank.

assetstringrequired

The asset the fee is denominated in, e.g., USD.

quoted_amountintegerrequired

The quoted amount in base units for the fee.

executed_amountinteger

The executed amount in base units for the fee.

FeeDetail

typebank | platform | networkrequired

The type of fee; one of bank, platform, or network.

assetstringrequired

The asset the fee is denominated in, e.g., USD.

amountintegerrequired

The fee amount in base units of the asset.

HoldDetail

typecustomer_hold_duration | reserve_below_minimum | screening_administrative | screening_non_administrative

The type of hold; one of customer_hold_duration, reserve_below_minimum, screening_administrative, or screening_non_administrative.

stateactive | completed | storingrequired

The state of the hold; one of active, completed, or storing

started_atstring<date-time>required

ISO8601 datetime the hold was started at.

completed_atstring<date-time>

ISO8601 datetime the hold was completed at.

eta_atstring<date-time>

ISO8601 datetime the hold is expected to complete at.

AccountAssociation

guidstringrequired

Auto-generated unique identifier for the transfer account.

typestringrequired

The type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.

organization_guidstring

The account's organization identifier.

bank_guidstring

The account's bank identifier.

customer_guidstring

The account's customer identifier.

counterparty_guidstring

The account's counterparty identifier.

assetstringrequired

The account asset, e.g., USD.

requested_amountinteger

The requested amount in base units intended to transfer from or to the account.

quoted_amountinteger

The quoted amount in base units to transfer from or to the account.

executed_amountinteger

The executed amount in base units transferred from or to the account.

payment_railach | eft | wire | rtp | etransfer

The desired payment rail to use to initiate a fiat transfer.

TravelRuleInfoParty

typestringrequired

The type of entity; one of bank, customer, or counterparty.

participant_guidstringrequired

The unique identifier for the participant.

QuoteEntry

source_accountobject

The source account in the batch transfer entry.

guidstring

Auto-generated unique identifier for the transfer account.

typestring

The type of transfer account; one of external_wallet.

bank_guidstring

The account's identifier.

customer_guidstring

The account's identifier.

destination_accountobject

The destination account entry in the batch transfer.

guidstring

Auto-generated unique identifier for the transfer account.

typestring

The type of transfer account; one of trading, fiat, external_bank_account, external_wallet, one_time_address, reserve, invoice_operations, fee, gas, or storage.

bank_guidstring

The account's identifier.

customer_guidstring

The account's identifier.

receive_amountinteger

The amount to be received in base units of the currency

deliver_amountinteger

The amount to be delivered in base units of the currency

feeinteger

The fee associated with the account entry.

QuoteList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

Workflow

guidstring

Auto-generated unique identifier for the workflow.

bank_guidstring

The associated banks's identifier.

customer_guidstring

The associated customer's identifier.

typestring

The type of workflow; one of plaid.

statestring

The state of the workflow; one of storing, completed, or failed.

failure_codestring

The failure code for failed workflows.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

PersonaSession

identity_verification_guidstringrequired

The unique identifier for the identity verification.

persona_inquiry_idstringrequired

The unique identifier for the Persona inquiry.

persona_session_tokenstringrequired

The token to be used in the Persona session.

PostPersonaSession

Request body for persona session creation.

persona_inquiry_idstringrequired

The ID of the Persona inquiry to create a session for

identity_verification_guidstringrequired

The GUID of the identity verification associated with the session

SardineSession

guidstringrequired

Auto-generated unique identifier for the sardine session key.

sardine_session_keystringrequired

The session key to initialize the Sardine SDK with.

customer_guidstringrequired

The unique identifier for the customer.

expires_atstring<date-time>

The expiration datetime of the session key. Null if the session key does not expire.

PostSardineSession

Request body for sardine session creation.

customer_guidstring

The GUID of the customer the session is for. Required for organization and bank subject tokens. For customer subject tokens, this is inferred from the token.

Transfer

guidstring

Auto-generated unique identifier for the transfer.

transfer_typestring

The type of transfer; one of funding, book, crypto, instant_funding, funding_return, crypto_return, loss_recovery, inter_account, lightning, or instant_funding_return.

bank_guidstring

The associated bank's identifier.

customer_guidstring

The associated customer's identifier.

quote_guidstring

The associated quote's identifier.

external_bank_account_guidstring

The associated external bank account's identifier.

assetstring

The asset the transfer is related to, e.g., USD.

sidestring

The direction of the quote; one of deposit or withdrawal.

statestring

The state of the transfer; one of storing, pending, reviewing, completed, or failed.

failure_codestring

The failure code for failed transfers; one of non_sufficient_funds, refresh_required, party_name_invalid, payment_rail_invalid, compliance_rejection, cancelled, reversed, limit_exceeded, network_fee_too_low, amount_too_low, internal_error, invalid_address, invalid_destination, customer_action_required, external_vendor_error, or payment_request_expired.

return_codestring

The return code for reversed transfers

amountinteger

The actual amount in base units of the asset.

estimated_amountinteger

The estimated amount in base units of the asset.

feeinteger

The fee associated with the transfer. Represents the sum of the bank and platform fees.

fee_detailsobject[]

The fees associated with the transfer.

estimated_network_feeinteger

The estimated network fee in base units of network_fee_asset. Only present on `crypto` transfers.

network_feeinteger

The actual network fee in base units of network_fee_asset. Only present on `crypto` transfers that have successfully completed.

network_fee_assetstring

The asset code of the network fee. Only present on `crypto` transfers that have successfully completed.

network_fee_liability_amountinteger

The equivalent fiat network fee in base units of network_fee_liability_amount_asset. Only present on `crypto` transfers that have successfully completed.

network_fee_liability_amount_assetstring

The fiat asset the network_fee_liability_amount is denominated in. Only present on `crypto` transfers that have successfully completed.

txn_hashstring

The hash of the blockchain transaction (deprecated: use identifiers array)

identifiersobject[]

Array of identifiers associated with this transfer (transaction hash, wire reference numbers)

reference_transfer_guidstring

The guid of the related transfer. Only present on return type transfers.

source_accountobject

The source account in the transfer. Can be omitted for crypto deposits.

guidstring

Auto-generated unique identifier for the transfer account.

typestring

The type of transfer account; one of trading, fiat, external_bank_account, external_wallet, one_time_address, reserve, invoice_operations, fee, gas, or storage.

bank_guidstring

The account's identifier.

customer_guidstring

The account's identifier.

source_participantsobject[]

The participants in the source account.

destination_accountobject

The destination account in the transfer.

guidstring

Auto-generated unique identifier for the transfer account.

typestring

The type of transfer account; one of trading, fiat, external_bank_account, external_wallet, one_time_address, reserve, invoice_operations, fee, gas, or storage.

bank_guidstring

The account's identifier.

customer_guidstring

The account's identifier.

destination_participantsobject[]

The participants in the source account.

deposit_address_guidstring

The guid of the deposit address. Only present on crypto deposits.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

hold_detailsobject

The hold details if a transfer is or will be placed on a hold.

applicable_typesstring[]

The list of hold types that are applicable for the transfer; one of administrative or non_administrative.

durationinteger

The approximate time (in seconds) that the transfer will be held for.

started_atstring<date-time>

ISO8601 datetime the transfer hold was started at.

transfer_detailsobject

The raw details on the transfer from the bank.

payment_railstring

The rail the payment was done on. One of: ach, eft, wire, rtp, etransfer

external_idstring

The external identifier for the transfer.

labelsstring[]

The labels associated with the transfer.

entriesobject[]

Transfer entries associated with the batch transfer

TransferEntry

amountintegerrequired

The actual amount in base units of the asset.

feeintegerrequired

The fee associated with the transfer entry.

source_accountobjectrequired

The source account in the batch transfer entry.

guidstring

Auto-generated unique identifier for the transfer account.

typestring

The type of transfer account; one of external_wallet.

bank_guidstring

The account's identifier.

customer_guidstring

The account's identifier.

destination_accountobjectrequired

The destination account entry in the batch transfer.

guidstring

Auto-generated unique identifier for the transfer account.

typestring

The type of transfer account; one of trading, fiat, external_bank_account, external_wallet, one_time_address, reserve, invoice_operations, fee, gas, or storage.

bank_guidstring

The account's identifier.

customer_guidstring

The account's identifier.

TransferParticipant

typestringrequired

The type of participant; one of unknown, bank, customer, or counterparty.

amountintegerrequired

The amount in base units of the asset.

guidstring

The participant's identifier.

Trade

guidstring

Auto-generated unique identifier for the trade.

trade_typestring

The type of trade; one of platform, liquidation, or exit.

customer_guidstring

The associated customer's identifier.

quote_guidstring

The associated quote's identifier.

symbolstring

The trade symbol the pricing is related to. Format is asset-counter_asset, e.g., BTC-USD.

sidestring

The direction of the trade; one of buy or sell.

statestring

The state of the trade; one of storing, pending, cancelled, completed, settling, or failed.

failure_codestring

The failure code for failed trades; one of non_sufficient_funds, unsupported, limit_exceeded, expired_quote, market_volatility, or not_filled.

receive_amountinteger

The amount to be received in base units of the currency: currency is "asset" for buy and "counter_asset" for sell.

deliver_amountinteger

The amount to be delivered in base units of the currency: currency is "counter_asset" for buy and "asset" for sell.

feeinteger

The fee associated with the trade. Denominated in "counter_asset" base units. Represents the sum of the bank and platform fees.

fee_detailsobject[]

The fees associated with the trade.

reference_trade_guidstring

The guid of the related trade. Only present on `exit` trades.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

labelsstring[]

The labels associated with the trade.

ExternalWalletList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

ExternalBankAccountList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

TransferList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

TradeList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

WorkflowsList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

Account

typestring

The account type; one of trading, fee, fiat, gas, reserve, invoice_operations, or storage.

guidstring

Auto-generated unique identifier for the account.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

assetstring

The asset code.

namestring

The name of the account.

bank_guidstring

The bank identifier associated with the account.

customer_guidstring

The customer identifier associated with the account.

platform_balanceinteger

The amount of funds that are in the account, in base units of the asset.

minimum_balance_funding_pullinteger

The minimum balance for no-hold ACH pulls, in base units of the account asset. Only returned for reserve accounts.

platform_availableinteger

The amount of funds that are in the account, in base units of the asset, that are available for use on the platform.

statestring

The state of the account; one of storing or created.

labelsstring[]

The labels associated with the account.

AccountList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

ExternalBankAccount

guidstring

Auto-generated unique identifier for the account.

namestring

The name of the account.

assetstring

The asset code.

account_kindstring

The type of account; one of plaid, plaid_processor_token, or raw_routing_details.

environmentstring

The environment that the external bank account is operating in; one of sandbox or production.

bank_guidstring

The bank identifier.

customer_guidstring

The customer identifier.

counterparty_guidstring

The counterparty identifier.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

plaid_institution_idstring

The Plaid institution ID for the account.

plaid_account_maskstring

The account number mask for the account.

plaid_account_namestring

The name for the account.

statestring

The state of the external bank account; one of storing, completed, failed, refresh_required, unverified, deleting, or deleted.

failure_codestring

The failure code for failed transfers.

balance_updated_atstring<date-time>

The timestamp that the balance information was last updated at.

balancesobject

Balance information for the account.

availableinteger

The available balance in the account.

currentinteger

The current balance in the account including pending transactions.

piiobject[]

The account holder information.

IdentificationNumber

typestringrequired

The source of the identification number; one of drivers_license, passport, passport_card, visa, residence_card, social_security_number, tax_identification_number, identification_card, work_permit, indigenous_document_number, national_identification_number, employer_identification_number, or business_registration_number.

issuing_country_codestringrequired

The ISO 3166 country 2-Alpha country code of the identification number issuer.

identification_numberstringrequired

The identification number.

issuing_subdivisionstring

The ISO 3166-2 subdivision code of the identification number issuer.

ExternalWallet

guidstring

Auto-generated unique identifier for the wallet.

namestring

The name of the wallet.

assetstring

The asset code.

environmentstring

The environment that the wallet is configured for; one of sandbox or production.

bank_guidstring

The bank identifier.

customer_guidstring

The customer identifier.

counterparty_guidstring

The counterparty identifier.

addressstring

The blockchain wallet address for the wallet.

tagstring

The blockchain tag to use when transferring crypto to the wallet.

created_atstring<date-time>

ISO8601 datetime the record was created at.

updated_atstring<date-time>

ISO8601 datetime the record was last updated at.

statestring

The state of the external wallet; one of storing, pending, failed, completed, deleting, or deleted.

failure_codestring

The failure code of an external wallet (if any)

PostBank

Request body for bank creation.

typesandboxrequired

The type of bank.

namestringrequired

The name of the bank.

supported_trading_symbolsstring[]required

The trading symbols supported by the bank.

supported_payout_symbolsobject[]

The payout symbols supported by the bank. This is not yet supported and should be nil or empty.

supported_fiat_account_assetsstring[]required

The fiat account assets supported by the bank.

supported_country_codesstring[]required

The country codes supported by the bank.

featuresstring[]required

The features supported by the bank.

cors_allowed_originsstring[]

The list of allowed CORS origin URIs.

PatchBank

Request body for bank modification.

namestring

The name of the bank.

supported_trading_symbolsstring[]

The trading symbols supported by the bank.

supported_payout_symbolsobject[]

The payout symbols supported by the bank. This is not yet supported and should be nil or empty.

cors_allowed_originsstring[]

The list of allowed CORS origin URIs.

PostCustomer

Request body for customer creation.

typebusiness | individualrequired

The type of customer.

addressobject

The customer's address.

streetstringrequired

The first line of the address.

street2string

The optional second line of the address.

citystringrequired

The city of the address.

subdivisionstring

The ISO 3166-2 subdivision code of the address. Applicable only for countries that use subnational states, provinces, lands, oblasts or regions.

postal_codestring

The postal, zip or post code of the address. Applicable only for countries that use postal, zip or post codes.

country_codestringrequired

The ISO 3166 country 2-Alpha country code of the address.

phone_numberstring

The customer's phone number.

email_addressstring

The customer's email address.

identification_numbersobject[]

The customer's identification numbers.

nameobject

The customer's name. Optional when type is individual or type is business.

firststring

The customer's first name. Required when type is individual.

middlestring

The customer's middle name. Optional when type is individual.

laststring

The customer's last name. Required when type is individual.

fullstring

The customer's full name. Required when type is business.

date_of_birthstring<date>

The customer's date of birth. Optional when type is individual.

aliasesobject[]

The aliases of the customer. Optional when type is business.

websitestring

The customer's website. Optional when type is business.

labelsstring[]

The labels associated with the customer.

PatchCustomer

Request body for customer modification.

stateunverified

The customer's state.

PostCounterparty

Request body for counterparty creation.

typebusiness | individualrequired

The counterparty's type.

customer_guidstring

The owning customer's identifier.

addressobjectrequired

The address of the counterparty.

streetstring

The first line of the address.

street2string

The optional second line of the address.

citystring

The city of the address.

subdivisionstring

The ISO 3166-2 subdivision code of the address. Applicable only for countries that use subnational states, provinces, lands, oblasts or regions.

postal_codestring

The postal, zip or post code of the address. Applicable only for countries that use postal, zip or post codes.

country_codestringrequired

The ISO 3166 country 2-Alpha country code of the address.

nameobject

The name of the counterparty. Required when type is business or type is individual.

fullstring

The counterparty's full name. Required when type is business.

firststring

The counterparty's first name. Required when type is individual.

middlestring

The counterparty's middle name. Optional when type is individual.

laststring

The counterparty's last name. Required when type is individual.

aliasesobject[]

The aliases of the counterparty. Optional when type is business.

date_of_birthstring<date>

The counterparty's date of birth. Optional when type is individual.

email_addressstring

The counterparty's email address.

identification_numbersobject[]

The counterparty's identification numbers.

labelsstring[]

The labels associated with the counterparty.

PostIdentityVerification

Request body for identity verification creation.

typekyc | bank_account | counterpartyrequired

The type of identity verification.

customer_guidstring

The customer's identifier. Required when type is kyc and method is attested_business_registration, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, or type is kyc and method is attested_id_and_database.

expected_behavioursstring[]

The optional expected behaviour to simulate.

methodwatchlists | attested | document_submission | enhanced_due_diligence | id_and_selfie | tax_id_and_selfie | business_registration | attested_id_and_selfie | attested_business_registration | attested_business_associate | attested_id_and_database | attested_ownership | account_ownership

The identity verification method. Required when type is counterparty, type is kyc, or type is bank_account.

counterparty_guidstring

The counterparty's identifier. Required when type is counterparty.

country_codestring

The ISO 3166 country 2-Alpha country the customer is being verified in. If not present, will default to the Bank's configured country code. Optional when type is kyc and method is id_and_selfie, type is kyc and method is tax_id_and_selfie, or type is kyc and method is business_registration.

require_tax_idboolean

Whether the collection of the tax id is required during identity verification. This will default to SSN in USA and SIN in Canada. It's not used elsewhere. Optional when type is kyc and method is id_and_selfie.

nameobject

The customer's name. Required when type is kyc and method is attested, type is kyc and method is attested_business_registration, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, type is kyc and method is attested_id_and_database, or type is bank_account and method is attested_ownership. Optional when type is kyc and method is watchlists.

firststring

The customer's first name. Required when type is kyc and method is attested, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, or type is kyc and method is attested_id_and_database. Optional when type is kyc and method is watchlists or type is bank_account and method is attested_ownership.

middlestring

The customer's middle name. Optional when type is kyc and method is attested, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, type is kyc and method is attested_id_and_database, type is kyc and method is watchlists, or type is bank_account and method is attested_ownership.

laststring

The customer's last name. Required when type is kyc and method is attested, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, or type is kyc and method is attested_id_and_database. Optional when type is kyc and method is watchlists or type is bank_account and method is attested_ownership.

fullstring

The customer's full name. Required when type is kyc and method is attested_business_registration or type is bank_account and method is attested_ownership. Optional when type is kyc and method is attested, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, type is kyc and method is attested_id_and_database, or type is kyc and method is watchlists.

addressobject

The customer's address. Required when type is kyc and method is attested, type is kyc and method is attested_business_registration, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, or type is kyc and method is attested_id_and_database. Optional when type is kyc and method is watchlists or type is bank_account and method is attested_ownership.

streetstring

The first line of the address. Required when type is kyc and method is attested, type is kyc and method is attested_business_registration, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, type is kyc and method is attested_id_and_database, type is kyc and method is watchlists, or type is bank_account and method is attested_ownership.

street2string

The optional second line of the address. Optional when type is kyc and method is attested, type is kyc and method is attested_business_registration, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, type is kyc and method is attested_id_and_database, type is kyc and method is watchlists, or type is bank_account and method is attested_ownership.

citystring

The city of the address. Required when type is kyc and method is attested, type is kyc and method is attested_business_registration, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, type is kyc and method is attested_id_and_database, type is kyc and method is watchlists, or type is bank_account and method is attested_ownership.

subdivisionstring

The ISO 3166-2 subdivision code of the address. Applicable only for countries that use subnational states, provinces, lands, oblasts or regions. Optional when type is kyc and method is attested, type is kyc and method is attested_business_registration, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, type is kyc and method is attested_id_and_database, type is kyc and method is watchlists, or type is bank_account and method is attested_ownership.

postal_codestring

The postal, zip or post code of the address. Applicable only for countries that use postal, zip or post codes. Optional when type is kyc and method is attested, type is kyc and method is attested_business_registration, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, type is kyc and method is attested_id_and_database, type is kyc and method is watchlists, or type is bank_account and method is attested_ownership.

country_codestring

The ISO 3166 country 2-Alpha country code of the address. Required when type is kyc and method is attested, type is kyc and method is attested_business_registration, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, type is kyc and method is attested_id_and_database, type is kyc and method is watchlists, or type is bank_account and method is attested_ownership.

date_of_birthstring<date>

The customer's date of birth. Required when type is kyc and method is attested, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, or type is kyc and method is attested_id_and_database.

identification_numbersobject[]

The customer's identification numbers. Required when type is kyc and method is attested, type is kyc and method is attested_business_registration, type is kyc and method is attested_business_associate, or type is kyc and method is attested_id_and_database. Optional when type is kyc and method is attested_id_and_selfie.

aliasesobject[]

The aliases of the customer. Optional when type is kyc and method is attested_business_registration or type is kyc and method is watchlists.

phone_numberstring

The customer's phone number. Required when type is kyc and method is attested_business_registration, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, or type is kyc and method is attested_id_and_database. Optional when type is bank_account and method is attested_ownership.

email_addressstring

The customer's email address. Required when type is kyc and method is attested_business_registration, type is kyc and method is attested_id_and_selfie, type is kyc and method is attested_business_associate, or type is kyc and method is attested_id_and_database. Optional when type is bank_account and method is attested_ownership.

websitestring

The customer's website. Required for attested business registration V2, optional for V3. Optional when type is kyc and method is attested_business_registration.

nature_of_businessstring

The customer's nature of business. Required when type is kyc and method is attested_business_registration.

director_customer_guidsstring[]

The customer guids of the directors of the business Required when type is kyc and method is attested_business_registration.

ultimate_beneficial_ownersobject[]

The ultimate beneficial owners of the business with 25% or more ownership. Required for attested business registration V2, optional for V3. Optional when type is kyc and method is attested_business_registration.

supporting_file_guidsstring[]

File guids supporting the verification Required when type is kyc and method is attested_business_registration, type is kyc and method is attested_business_associate, or type is kyc and method is attested_id_and_database. Optional when type is kyc and method is attested_id_and_selfie.

registered_addressobject

The customer's registered address. Required for attested business registration V3. Optional when type is kyc and method is attested_business_registration.

streetstring

The first line of the address. Required when type is kyc and method is attested_business_registration.

street2string

The optional second line of the address. Optional when type is kyc and method is attested_business_registration.

citystring

The city of the address. Required when type is kyc and method is attested_business_registration.

subdivisionstring

The ISO 3166-2 subdivision code of the address. Applicable only for countries that use subnational states, provinces, lands, oblasts or regions. Optional when type is kyc and method is attested_business_registration.

postal_codestring

The postal, zip or post code of the address. Applicable only for countries that use postal, zip or post codes. Optional when type is kyc and method is attested_business_registration.

country_codestring

The ISO 3166 country 2-Alpha country code of the address. Required when type is kyc and method is attested_business_registration.

business_industrystring

The industry the business operates in. Required for attested business registration V3. e.g. 'Crypto / Digital Assets / Blockchain', 'Education', 'Gaming', 'Healthcare / Hospitality', 'Lending / Investments', 'Retail / E-Commerce', etc. Optional when type is kyc and method is attested_business_registration.

business_funds_sourcestring

The source of business funds. Required for attested business registration V3. e.g. 'Funds from individual customers', 'Funds from business customers', 'Funds from both individual and business customers', etc. Optional when type is kyc and method is attested_business_registration.

business_funds_destinationstring

The destination of business funds. Required for attested business registration V3. e.g. 'To your business account (bank or wallet)', 'To vendors or suppliers', 'To employees or contractors', 'To sellers or merchants', 'Bulk payments or payouts', etc. Optional when type is kyc and method is attested_business_registration.

occupationstring

The customer's occupation. Required when type is kyc and method is attested_business_associate. Optional when type is kyc and method is attested_id_and_selfie.

biometrics_verifiedboolean

Whether biometrics have been verified Required when type is kyc and method is attested_business_associate or type is kyc and method is attested_id_and_database.

external_bank_account_guidstring

The external bank account's identifier. Required when type is bank_account.

PostIdentificationNumber

Identification number details.

typedrivers_license | passport | passport_card | visa | residence_card | social_security_number | tax_identification_number | identification_card | work_permit | indigenous_document_number | national_identification_number | employer_identification_number | business_registration_numberrequired

The source of the identification number.

issuing_country_codestringrequired

The ISO 3166 country 2-Alpha country code of the identification number issuer.

identification_numberstringrequired

The identification number.

issuing_subdivisionstring

The ISO 3166-2 subdivision code of the identification number issuer.

PostUltimateBeneficialOwner

Identification number details.

customer_guidstringrequired

The customer identifier.

ownership_percentagenumberrequired

The ownership percentage.

PostFile

Request body for a new file.

typedrivers_license_front | drivers_license_back | drivers_license | passport | passport_card | visa | identification_card | residence_card | work_permit | indigenous_id_document | selfie | selfie_video | selfie_left | selfie_right | utility_bill | proof_of_address | bank_statement | property_tax | tax_document | ein_letter | incorporation_certificate | invoice | purchase_order | delivery_slip | contract | bill_of_lading | others | persona_inquiry_report | persona_inquiry_exportrequired

The type of file.

customer_guidstringrequired

The customer identifier.

filenamestringrequired

The name of the file.

content_typeimage/jpeg | image/png | application/pdf | application/json | video/mp4required

The content type of the file.

datastring

Base64 encoded file content

metadataobject

File metadata (e.g., {"part": "front"})

partfront | back

The part of the file (e.g., "front", "back")

PostDepositAddress

Request body for deposit address creation.

namestring

The name of the deposit address.

account_guidstringrequired

The trading account guid.

labelsstring[]

The labels associated with the address.

PatchDepositAddress

Request body for deposit address modification.

namestring

The name of the deposit address.

PatchDepositBankAccount

Request body for deposit bank account modification.

namestring

The name of the deposit bank account.

PostSupportedPayoutSymbols

Supported payout symbols details.

primary_assetstringrequired

The primary asset of the payout symbol, e.g., MXN.

counter_assetstringrequired

The counter asset of the payout symbol, e.g., USD.

country_codestringrequired

The ISO 3166 country 2-Alpha country code is permitted in, e.g., MX.

participants_typeC2C | C2B | B2C | B2Brequired

The participants the symbol is permitted for.

routebank_account | mobile_walletrequired

The route the symbol is permitted for.

PostAccount

Request body for account creation.

typetrading | fiat | invoice_operations | storagerequired

The account type.

customer_guidstring

The customer identifier associated with the account.

assetstringrequired

The asset code.

namestringrequired

The name of the account.

labelsstring[]

The labels associated with the account.

PatchAccount

Request body for account modification.

namestring

The name of the account.

PostWorkflow

Request body for workflow creation.

typeplaidrequired

The workflow type.

kindlink_token_create | link_token_update

The Plaid workflow kind. Required when type is plaid.

customer_guidstring

The customer identifier associated with the workflow. Optional when type is plaid and kind is link_token_create.

external_bank_account_guidstring

The external bank account identifier associated with the workflow. Required when type is plaid and kind is link_token_update.

languageen | fr | es | nl | de

The language to initialize Plaid link. Required when type is plaid.

link_customization_namestring

The customization name for Plaid link. For English, use "default". For Spanish, use "spanish_customization". Required when type is plaid.

redirect_uristring

The redirect URI for Plaid link. Optional when type is plaid.

android_package_namestring

The Android package name for Plaid link. Optional when type is plaid.

PatchTransfer

Request body for transfer modification.

source_participantsobject[]

The source participants for the transfer.

destination_participantsobject[]

The destination participants for the transfer.

PatchTransferParticipant

Request body for a transfer participant.

typebank | customer | counterpartyrequired

The type of participant.

amountintegerrequired

The amount in base units of the asset.

guidstringrequired

The participant's identifier.

PostTransfer

Request body for transfer creation.

quote_guidstringrequired

The associated quote's identifier.

transfer_typefunding | crypto | instant_funding | inter_account | lightning | bookrequired

The type of transfer.

external_bank_account_guidstring

The customer's 'plaid', 'plaid_processor_token', or 'raw_routing_details' external bank account's identifier. Required for ACH, EFT, WIRE, and RTP payment rails. Not used for e-transfer rail. Required when transfer_type is instant_funding. Optional when transfer_type is funding.

fiat_account_guidstring

The identifier for the fiat account to use for the transfer. Required if the customer or bank has multiple fiat accounts. Optional when transfer_type is funding.

send_as_deposit_bank_account_guidstring

The deposit bank account's identifier. Only valid for withdrawals. The deposit bank account must be owned by the customer or bank initiating the transfer. Optional when transfer_type is funding.

payment_railach | eft | wire | rtp | etransfer

The desired payment rail to initiate the transfer for. Optional when transfer_type is funding.

beneficiary_memostring

The memo to send to the counterparty. Optional when transfer_type is funding.

security_questionstring

The security question to send with an Interac E-Transfer withdrawal. Only accepted for e-transfer rail withdrawals; must be paired with security_answer. Optional when transfer_type is funding.

security_answerstring

The security answer the recipient must provide to claim an Interac E-Transfer. Only accepted for e-transfer rail withdrawals; must be paired with security_question. Optional when transfer_type is funding.

source_participantsobject[]

The source participants for the transfer. Required when transfer_type is funding, transfer_type is instant_funding, transfer_type is book, transfer_type is crypto, or transfer_type is lightning.

destination_participantsobject[]

The destination participants for the transfer. Required when transfer_type is funding, transfer_type is instant_funding, transfer_type is book, transfer_type is crypto, or transfer_type is lightning.

sardine_session_guidstring

The GUID of a previously created Sardine session. Used to correlate device signals from the Sardine SDK with the transfer screening. Optional when transfer_type is funding or transfer_type is instant_funding.

bank_fiat_account_guidstring

The identifier for the fiat account to use for the transfer. Required if the bank has multiple fiat accounts. Optional when transfer_type is instant_funding or transfer_type is lightning.

customer_fiat_account_guidstring

The identifier for the fiat account to use for the transfer. Required if the customer has multiple fiat accounts. Optional when transfer_type is instant_funding or transfer_type is lightning.

source_account_guidstring

The source account's identifier. Required when transfer_type is book or transfer_type is inter_account.

destination_account_guidstring

The destination account's identifier. Required when transfer_type is book or transfer_type is inter_account.

external_wallet_guidstring

The customer's external wallet's identifier. Optional when transfer_type is crypto.

customer_guidstring

The customer's identifier. Required when transfer_type is lightning.

network_fee_account_guidstring

The network fee account's identifier. Required for network fee transfers. Must be the identifier for the customer's or bank's fiat or trading account. For customer's to pay the network fees, include the customer's fiat or trading account guid. For bank's to pay the network fees, include the bank's fiat or trading account guid. Required when transfer_type is lightning.

expected_behavioursstring[]

The optional expected behaviour to simulate. Only applicable for transfers under sandbox banks. The force_review behaviour will force the transfer to be reviewed for funding and instant_funding transfers.

labelsstring[]

The labels associated with the transfer.

PostTransferParticipant

Request body for a transfer participant.

typebank | customer | counterpartyrequired

The type of participant.

amountintegerrequired

The amount in base units of the asset.

guidstringrequired

The participant's identifier.

PostTrade

Request body for trade creation.

trade_typeplatform

The type of trade.

quote_guidstringrequired

The associated quote's identifier.

fiat_account_guidstring

The identifier for the fiat account to use for the trade. Required if the customer or bank has multiple fiat accounts.

expected_errorexpired_quote | non_sufficient_funds

The optional expected error to simulate trade failure.

labelsstring[]

The labels associated with the trade.

PatchExternalBankAccount

Request body for external bank account modification.

statecompleted | refresh_required

The state of the external bank account. If set to "completed," the returned state of the external bank account will be either "completed", if the bank account has been verified, or "unverified" if the bank account has not been verified.

namestring

The name of the external bank account.

PostExternalBankAccount

Request body for external bank account creation.

namestringrequired

The name of the account.

account_kindplaid | plaid_processor_token | raw_routing_detailsrequired

The account type

customer_guidstring

The customer identifier.

assetstring

The asset code. If not set will try and default to the Bank's configured fiat asset.

plaid_public_tokenstring

The public token for the account. Required for 'plaid' accounts. Required when account_kind is plaid.

plaid_account_idstring

The account identifier in plaid. Required for 'plaid' accounts. Required when account_kind is plaid.

plaid_processor_tokenstring

The Plaid processor token used to access the account. Required when account_kind is plaid_processor_token.

plaid_institution_idstring

Plaid's institution ID for the account's institution. Required when account_kind is plaid_processor_token.

plaid_account_maskstring

The account mask for the account. Required when account_kind is plaid_processor_token.

plaid_account_namestring

The name of the account. Required when account_kind is plaid_processor_token.

counterparty_guidstring

The counterparty identifier. Optional when account_kind is raw_routing_details.

counterparty_bank_accountobject

The counterparty's checking bank account information. Required when account_kind is raw_routing_details.

routing_number_typeCPA | ABA | IFSC

The type of routing number. Required when account_kind is raw_routing_details.

routing_numberstring

The routing number. Required when account_kind is raw_routing_details.

account_numberstring

The account number. Required when account_kind is raw_routing_details.

counterparty_nameobject

The counterparty's name on their checking account. Required when account_kind is raw_routing_details and counterparty_guid is not present.

firststring

The counterparty's first name; used for individuals. Optional when account_kind is raw_routing_details and counterparty_guid is not present.

middlestring

The counterparty's middle name; used for individuals. Optional when account_kind is raw_routing_details and counterparty_guid is not present.

laststring

The counterparty's last name; used for individuals. Optional when account_kind is raw_routing_details and counterparty_guid is not present.

fullstring

The counterparty's full name; used for businesses. Optional when account_kind is raw_routing_details and counterparty_guid is not present.

counterparty_addressobject

The counterparty's address on their checking account. Required when account_kind is raw_routing_details and counterparty_guid is not present.

streetstring

The first line of the address. Required when account_kind is raw_routing_details and counterparty_guid is not present.

street2string

The optional second line of the address. Optional when account_kind is raw_routing_details and counterparty_guid is not present.

citystring

The city of the address. Required when account_kind is raw_routing_details and counterparty_guid is not present.

subdivisionstring

The ISO 3166-2 subdivision code of the address. Applicable only for countries that use subnational states, provinces, lands, oblasts or regions. Optional when account_kind is raw_routing_details and counterparty_guid is not present.

postal_codestring

The postal, zip or post code of the address. Applicable only for countries that use postal, zip or post codes. Optional when account_kind is raw_routing_details and counterparty_guid is not present.

country_codestring

The ISO 3166 country 2-Alpha country code of the address. Required when account_kind is raw_routing_details and counterparty_guid is not present.

counterparty_email_addressstring

The counterparty's email address on their checking account. Optional when account_kind is raw_routing_details and counterparty_guid is not present.

PostBankAccountDetails

Bank account details.

bank_codestring

The bank code.

account_identifierstringrequired

The account number or unique identifier for the account.

account_identifier_typeCLABE | PHONE_NUMBER | EMAIL | DEBIT_CARD | CBU | CVU | RANDOM | CPF | CNPJ

The type of account identifier. Must be PHONE_NUMBER for mobile wallet rails. Required when payment_rail is EASY_PAISA, payment_rail is FINJA, payment_rail is JAZZ_CASH, payment_rail is NAYA_PAY, payment_rail is SADA_PAY, payment_rail is MPESA, or payment_rail is ALIPAY.

payment_railEFT | ACH | RTP | FEDNOW | WIRE | SPEI | PIX | COELSA | PSE | ETRANSFER | IFSC | SBP | BEFTN | NGBANK | LBTR | SEPA | EASY_PAISA | FINJA | JAZZ_CASH | NAYA_PAY | SADA_PAY | KEBANK | HKBANK | MPESA | CNBANK | FPS | ALIPAY | UNSPECIFIEDrequired

The payment rail used for the account.

bank_code_typeCPA | ABA | CLABE | PIX | CBU_CVU | PSE | IFSC | IBAN | SBP | BEFTN | SWIFT_BIC | CBN | SORT_CODE

The type of bank code. Required when payment_rail is EFT, payment_rail is ACH, payment_rail is RTP, payment_rail is FEDNOW, payment_rail is WIRE, payment_rail is SPEI, payment_rail is PIX, payment_rail is COELSA, payment_rail is PSE, payment_rail is ETRANSFER, payment_rail is IFSC, payment_rail is SBP, payment_rail is BEFTN, payment_rail is NGBANK, payment_rail is LBTR, payment_rail is SEPA, payment_rail is KEBANK, payment_rail is HKBANK, payment_rail is CNBANK, payment_rail is FPS, or payment_rail is UNSPECIFIED.

account_typechecking | savings

The type of account. Required when payment_rail is PSE or payment_rail is LBTR. Optional when payment_rail is ACH.

PostExternalWallet

Request body for external wallet creation.

namestringrequired

Name of the external wallet.

customer_guidstring

The customer identifier.

counterparty_guidstring

The counterparty identifier.

assetstringrequired

The asset code.

addressstringrequired

The blockchain wallet address for the wallet.

tagstring

The blockchain tag to use when transferring crypto to the wallet.

expected_behavioursstring[]

The optional expected behaviour to simulate. Only applicable wallets under sandbox banks.

PatchExternalWallet

Request body for external wallet modification.

namestring

The name of the external wallet.

PlatformFile

guidstring

The unique identifier for the file.

organization_guidstring

The organization identifier.

bank_guidstring

The bank identifier.

customer_guidstring

The customer identifier.

typestring

The file type; one of drivers_license_front, drivers_license_back, drivers_license, passport, passport_card, visa, identification_card, residence_card, work_permit, indigenous_id_document, selfie, selfie_video, selfie_left, selfie_right, utility_bill, proof_of_address, bank_statement, property_tax, tax_document, ein_letter, incorporation_certificate, invoice, purchase_order, delivery_slip, contract, bill_of_lading, others, persona_inquiry_report, or persona_inquiry_export.

content_typestring

The media type; one of image/jpeg, image/png, application/pdf, application/json, or video/mp4.

filenamestring

The name of the file.

completed_atstring<date-time>

The ISO8601 datetime the file was completed at.

failed_atstring<date-time>

The ISO8601 datetime the file failed at.

statestoring | completed | failed

The state of the file. One of storing, completed, or failed.

failure_codestring

The failure code for failed files.

upload_urlstring<uri>

The URL to upload the file to.

upload_expires_atstring<date-time>

The ISO8601 datetime the upload URL expires at.

download_urlstring<uri>

The URL to download the file from.

download_expires_atstring<date-time>

The ISO8601 datetime the download URL expires at.

PlatformFileList

totalintegerrequired

The total number of records available.

pageintegerrequired

The page index to retrieve.

per_pageintegerrequired

The number of entities per page to return.

objectsobject[]required

ErrorResponse

statusintegerrequired

Status code for Http Request

error_messagestringrequired

Error message

message_codestringrequired

Message code for Error