Objects
The object shapes referenced by the Cybrid BankAPI endpoints — identical to Cybrid's own schemas.
Asset
typestringrequiredThe asset type; one of fiat or crypto.
codestringrequiredThe unique code for the asset.
namestringrequiredThe name of the asset.
symbolstringrequiredThe currency symbol for the asset.
decimalsintegerrequiredThe number of decimals for the default unit of the asset.
ActivityLimit
typestringThe type of the limit; one of rolling, daily, weekly, or monthly.
namestringThe name of the limit.
assetstringThe asset code for the limit.
amountintegerThe limit amount for the asset.
intervalintegerThe limit interval in seconds for the asset.
activitiesstring[]The activities associated with the limit.
sidesstring[]The sides associated with the limit.
AssetList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredBank
guidstringrequiredAuto-generated unique identifier for the bank.
organization_guidstringrequiredThe organization's identifier.
namestringrequiredThe bank's name.
typestringrequiredThe 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[]requiredThe bank's enabled features.
cors_allowed_originsstring[]The bank's list of CORS allowed origins.
created_atstring<date-time>requiredISO8601 datetime the record was created at.
updated_atstring<date-time>ISO8601 datetime the record was last updated at.
BankList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredCounterparty
guidstringAuto-generated unique identifier for the counterparty.
typestringThe counterparty type; one of business or individual.
bank_guidstringAuto-generated unique identifier for the counterparty's bank.
customer_guidstringAuto-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.
statestringThe counterparty state; one of storing, unverified, verified, or rejected.
nameobjectThe counterparty's name. Only available for GET operations when 'include_pii' is set.
firststringThe counterparty's first name.
middlestringThe counterparty's middle name.
laststringThe counterparty's last name.
fullstringThe counterparty's full name.
addressobjectThe counterparty's address. Only available for GET operations when 'include_pii' is set.
streetstringThe first line of the address.
street2stringThe optional second line of the address.
citystringThe city of the address.
subdivisionstringThe ISO 3166-2 subdivision code of the address; not used by all countries.
postal_codestringThe postal/post/zip code of the address; not used by all countries.
country_codestringThe 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
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredCustomer
guidstringAuto-generated unique identifier for the customer.
bank_guidstringAuto-generated unique identifier for the customer's bank.
typestringThe 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.
statestringThe customer state; one of storing, unverified, verified, rejected, or frozen.
nameobjectThe customer's name. Only available for GET operations when 'include_pii' is set.
firststringThe customer's first name.
middlestringThe customer's middle name.
laststringThe customer's last name.
fullstringThe customer's full name.
addressobjectThe customer's address. Only available for GET operations when 'include_pii' is set.
streetstringThe first line of the address.
street2stringThe optional second line of the address.
citystringThe city of the address.
subdivisionstringThe ISO 3166-2 subdivision code of the address; not used by all countries.
postal_codestringThe postal/post/zip code of the address; not used by all countries.
country_codestringThe 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.
websitestringThe 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_numberstringThe customer's phone number. Only available for GET operations when 'include_pii' is set.
email_addressstringThe 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.
firststringThe legal entity's first name.
middlestringThe legal entity's middle name.
laststringThe legal entity's last name.
fullstringThe legal entity's full name.
PhysicalAddress
A physical address.
streetstringThe first line of the address.
street2stringThe optional second line of the address.
citystringThe city of the address.
subdivisionstringThe ISO 3166-2 subdivision code of the address; not used by all countries.
postal_codestringThe postal/post/zip code of the address; not used by all countries.
country_codestringThe ISO 3166 country 2-Alpha country code of the address.
CustomerList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredIdentityVerification
guidstringAuto-generated unique identifier for the identity verification.
typestringThe identity verification type; one of kyc, bank_account, or counterparty.
methodstringThe 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_guidstringThe customer's identifier.
counterparty_guidstringThe counterparty's identifier.
external_bank_account_guidstringThe external bank account's identifier.
statestringThe identity verification state; one of storing, waiting, pending, reviewing, expired, or completed.
outcomestringThe 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.
optionsobjectOptions for the identity verification.
require_tax_idbooleanWhether the tax ID was enforced during identity verification.
IdentityVerificationWithDetails
guidstringAuto-generated unique identifier for the identity verification.
typestringThe identity verification type; one of kyc, bank_account, or counterparty.
methodstringThe 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_guidstringThe identity verification's identifier.
counterparty_guidstringThe identity verification's identifier.
external_bank_account_guidstringThe identity verification's identifier.
statestringThe identity verification state; one of storing, waiting, pending, reviewing, expired, or completed.
outcomestringThe 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_idstringThe Persona identifier of the backing inquiry.
persona_statestringThe 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.
piiobjectThe personally identifiable information associated with the identity verification.
nameobjectThe attested name
aliasesobject[]The business attested aliases.
addressobjectThe attested address.
date_of_birthstring<date>The attested date of birth.
phone_numberstringThe attested phone number.
email_addressstringThe attested email address.
occupationstringThe attested occupation.
websitestringThe attested website.
nature_of_businessstringThe attested nature of business.
registered_addressobjectThe attested registered address.
business_industrystringThe attested business industry.
business_funds_sourcestringThe attested business funds source.
business_funds_destinationstringThe 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.
optionsobjectOptions for the identity verification.
require_tax_idbooleanWhether the tax ID was enforced during identity verification.
IdentityVerificationDocument
guidstringAuto-generated unique identifier for the document.
typestringThe 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.
validatedbooleanWhether the document has been validated.
expiration_datestring<date>The document expiration date.
filesobject[]The files associated with the document.
IdentityVerificationDocumentFile
guidstringThe unique identifier for the file.
typestringThe 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_typestringThe media type; one of image/jpeg, image/png, application/pdf, application/json, or video/mp4.
filenamestringThe name of the file.
metadataobjectFile metadata (e.g., {"part": "front"})
partfront | backThe part of the file (e.g., "front", "back")
IdentityVerificationBusinessAssociate
persona_inquiry_idstringThe Persona identifier of the business associate backing inquiry. Available only for attested_business_registration verification method
persona_statestringThe 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_guidstringThe business associate's customer identifier. Available only for attested_business_registration verification method
rolestringThe business associate role; one of director or owner.
email_addressstringThe business associate email address. Available only for business_registration verification method
statestringThe business associate state; one of completed, waiting, or pending.
IdentityVerificationList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredComplianceCheck
typestringrequiredThe 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.
outcomestringrequiredThe outcome of the compliance check; one of passed, failed, insufficient, or inconclusive.
failure_codesstring[]The reason codes explaining the outcome.
ComplianceDecision
typestringrequiredThe 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.
statestringrequiredThe 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.
namestringThe name of the deposit bank account.
typemain | sub_accountrequiredThe 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_guidstringrequiredThe fiat or reserve account guid.
customer_guidstringThe unique identifier for the customer.
parent_deposit_bank_account_guidstringThe 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.
assetstringrequiredThe asset code the customer will receive the funds in.
customer_guidstringThe unique identifier for the customer.
receive_amountintegerThe 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_amountintegerThe 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_guidstringThe 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_guidstringrequiredThe invoice guid.
expected_behaviourinvoice_paid_immediatelyThe optional expected behaviour to simulate.
Invoice
guidstringAuto-generated unique identifier for the payment instruction.
customer_guidstringThe customer identifier.
account_guidstringThe 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.
typestringThe type of invoice; one of lightning.
assetstringThe asset code the customer will receive the funds in.
receive_amountintegerThe 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_amountintegerThe 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.
feeintegerThe fee associated with this invoice in base units of the asset.
statestringThe state of the invoice; one of storing, unpaid, cancelling, cancelled, settling, or paid.
labelsstring[]The labels associated with the invoice.
InvoiceList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredPaymentInstruction
guidstringAuto-generated unique identifier for the payment instruction.
customer_guidstringThe customer identifier.
invoice_guidstringThe 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_addressstringThe network address to pay the invoice to.
expected_payment_assetstringThe asset the payor must pay the invoice in, e.g., BTC.
expected_payment_amountintegerThe amount to be paid in base units of expected_payment_asset.
failure_codestringThe reason code explaining the failure; ond of invoice_paid, invoice_cancelled, or invalid_amount.
statestringThe state of the payment instruction; one of storing, created, expired, or failed.
PaymentInstructionList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredDepositBankAccount
guidstringAuto-generated unique identifier for the identity verification.
namestringThe name of the deposit bank account.
typestringThe account type; one of main or sub_account.
bank_guidstringThe address' bank identifier.
customer_guidstringThe address' customer identifier.
account_guidstringThe 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.
assetstringThe asset the transfer is related to, e.g., USD.
statestringThe state of the deposit bank account; one of storing, created, deleting, or deleted.
unique_memo_idstringThe 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_namestringThe name of the account holder.
counterparty_addressobjectThe counterparty's address on the account.
streetstringrequiredThe first line of the address.
street2stringThe optional second line of the address.
citystringrequiredThe city of the address.
subdivisionstringThe ISO 3166-2 subdivision code of the address; not used by all countries.
postal_codestringThe postal/post/zip code of the address; not used by all countries.
country_codestringrequiredThe 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_guidstringThe unique identifier for the bank-level deposit bank account. This is only set for sub-accounts.
labelsstring[]The labels associated with the address.
DepositBankAccountList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredDepositAddress
guidstringAuto-generated unique identifier for the identity verification.
namestringThe name of the deposit address.
bank_guidstringThe address' bank identifier.
customer_guidstringThe address' customer identifier.
account_guidstringThe 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.
assetstringThe asset the transfer is related to, e.g., USD.
statestringThe state of the address; one of storing or created.
addressstringThe blockchain address.
formatstringThe blockchain address format; one of standard or legacy.
tagstringThe blockchain address tag.
labelsstring[]The labels associated with the address.
DepositAddressList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredSymbolPrice
symbolstringThe trade symbol the pricing is related to. Format is asset-counter_asset, e.g., BTC-USD.
typestringThe type of price; one of trading or payout.
buy_priceintegerThe purchase price (in base units) for the asset denominated in the counter asset currency.
sell_priceintegerThe 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_codestringThe ISO 3166 country 2-Alpha country code of the price.
participants_typestringThe type of participants the price is for; one of C2C, C2B, B2C, or B2B.
routestringThe 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_transferThe type of product the quote is for.
bank_guidstringThe unique identifier for the bank.
customer_guidstringThe unique identifier for the customer.
receive_amountintegerThe amount to be received in base units of the currency: currency is "asset" for buy and "counter_asset" for sell for trade quotes.
deliver_amountintegerThe amount to be delivered in base units of the currency: currency is "counter_asset" for buy and "asset" for sell for trade quotes.
assetstringThe 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_addressstringThe 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 | sellThe 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_guidstringThe 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 | etransferThe 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.
symbolstringSymbol 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_guidstringThe guid of the related trade. Only present on `exit` trades. Required when product_type is trading_exit.
source_account_guidstringThe source account's identifier. Required when product_type is inter_account.
PostQuoteEntry
Request body for quote account creation.
typeexternal_walletrequiredThe type of account
guidstringrequiredThe guid of the account
receive_amountintegerThe amount to be received in base units of the currency: currency is "asset" for buy and "counter_asset" for sell for trade quotes.
deliver_amountintegerThe 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 | fixedrequiredThe fee's type
spread_feeintegerThe percentage amount, in basis points, to apply when charging a fee. Required when type is spread.
fixed_feeintegerThe fixed amount to apply when charging a fee; for trades, the fiat asset is used. Required when type is fixed.
Quote
guidstringAuto-generated unique identifier for the quote.
product_typestringThe type of product the quote is for; one of trading, trading_exit, funding, crypto_transfer, inter_account, lightning_transfer, or book_transfer.
bank_guidstringThe unique identifier for the bank.
customer_guidstringThe unique identifier for the customer.
symbolstringSymbol the quote was requested for. Format is "asset-counter_asset" in uppercase. Populated for trade quotes.
sidestringThe direction of the quote; one of buy, sell, deposit, or withdrawal.
receive_amountintegerThe amount to be received in base units of the currency: currency is "asset" for buy and "counter_asset" for sell for trade quotes.
deliver_amountintegerThe amount to be delivered in base units of the currency: currency is "counter_asset" for buy and "asset" for sell for trade quotes.
feeintegerThe 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.
assetstringThe asset code the quote was requested for. Populated for book transfer and funding quotes.
network_feeintegerThe network fee in base units of network_fee_asset. Only present on `crypto_transfer` quotes.
network_fee_assetstringThe asset code of the network fee.
network_addressstringThe network address to pay the invoice to. Populated for lightning_transfer quotes.
entriesobject[]The quote entries for a batch transfer quote
trade_guidstringThe unique identifier for the trade.
transfer_guidstringThe unique identifier for the transfer.
PostPlan
Request body for plan creation.
typeremittancerequiredThe type of product the plan is for.
bank_guidstringThe unique identifier for the bank.
customer_guidstringThe unique identifier for the customer.
source_accountobjectrequiredSource account
guidstringrequiredThe source account's identifier.
amountintegerThe amount to be delivered in base units of the source account currency
payment_railach | eft | wire | rtp | etransferThe desired payment rail to use to initiate a fiat transfer from the source account.
destination_accountobjectrequiredDestination account
guidstringrequiredThe destination account's identifier.
amountintegerThe amount to be delivered in base units of the source account currency
payment_railach | eft | wire | rtp | etransferThe desired payment rail to use to initiate a fiat transfer to the destination account.
travel_rule_infoobjectTravel rule information
ultimate_originating_party_guidstringThe unique identifier for the ultimate originating party.
ultimate_receiving_party_guidstringThe 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_servicesThe 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
guidstringrequiredAuto-generated unique identifier for the entity.
typestringrequiredThe type of product the plan is for; one of remittance, deposit_return, or withdrawal_return.
bank_guidstringThe unique identifier for the bank.
customer_guidstringThe unique identifier for the customer.
created_atstring<date-time>requiredISO8601 datetime the record was created at.
updated_atstring<date-time>requiredISO8601 datetime the record was last updated at.
expires_atstring<date-time>requiredISO8601 datetime the plan will expire at. Null for return plans, which do not expire.
statestringrequiredThe state of the plan; one of storing, planning, completed, or failed.
failure_codestringThe failure code for failed plans.
source_accountobjectrequiredguidstringrequiredAuto-generated unique identifier for the transfer account.
typestringrequiredThe type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.
organization_guidstringThe account's organization identifier.
bank_guidstringThe account's bank identifier.
customer_guidstringThe account's customer identifier.
counterparty_guidstringThe account's counterparty identifier.
assetstringrequiredThe account asset, e.g., USD.
requested_amountintegerThe requested amount in base units intended to transfer from or to the account.
quoted_amountintegerThe quoted amount in base units to transfer from or to the account.
executed_amountintegerThe executed amount in base units transferred from or to the account.
payment_railach | eft | wire | rtp | etransferThe desired payment rail to use to initiate a fiat transfer.
destination_accountobjectrequiredguidstringrequiredAuto-generated unique identifier for the transfer account.
typestringrequiredThe type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.
organization_guidstringThe account's organization identifier.
bank_guidstringThe account's bank identifier.
customer_guidstringThe account's customer identifier.
counterparty_guidstringThe account's counterparty identifier.
assetstringrequiredThe account asset, e.g., USD.
requested_amountintegerThe requested amount in base units intended to transfer from or to the account.
quoted_amountintegerThe quoted amount in base units to transfer from or to the account.
executed_amountintegerThe executed amount in base units transferred from or to the account.
payment_railach | eft | wire | rtp | etransferThe desired payment rail to use to initiate a fiat transfer.
stagesobject[]requiredThe stages of the plan.
feesobject[]requiredThe fees associated with the plan.
travel_rule_infoobjectrequiredThe travel rule information associated with the plan.
originating_partyobjectrequiredreceiving_partyobjectrequiredultimate_originating_partyobjectultimate_receiving_partyobjectpurpose_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_servicesThe 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 | othersrequiredThe kind of supporting document.
file_guidsstring[]requiredFile guids backing this document.
document_reference_numberstringA reference number identifying this document (e.g. an invoice number). Required for payouts to certain corridors.
SupportingDocument
guidstringrequiredAuto-generated unique identifier for the document.
typeinvoice | purchase_order | delivery_slip | contract | bill_of_lading | othersrequiredThe kind of supporting document; one of invoice, purchase_order, delivery_slip, contract, bill_of_lading, or others.
filesobject[]requiredThe files backing this document.
document_reference_numberstringA reference number identifying this document (e.g. an invoice number).
SupportingDocumentFile
guidstringrequiredAuto-generated unique identifier for the file.
filenamestringrequiredThe original filename.
content_typestringrequiredThe MIME content type.
PlanList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredPostExecution
Request body for plan creation.
plan_guidstringrequiredThe unique identifier for the plan.
sardine_session_guidstringThe GUID of a previously created Sardine session. Used to correlate device signals from the Sardine SDK with the execution screening.
ExecutionList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredExecution
guidstringrequiredAuto-generated unique identifier for the quote.
typestringrequiredThe type of product the plan is for; one of remittance, deposit_return, or withdrawal_return.
plan_guidstringrequiredThe unique identifier for the plan.
bank_guidstringThe unique identifier for the bank.
customer_guidstringThe unique identifier for the customer.
created_atstring<date-time>requiredISO8601 datetime the record was created at.
updated_atstring<date-time>requiredISO8601 datetime the record was last updated at.
statestringrequiredThe state of the execution; one of storing, executing, completed, failed, or reviewing.
failure_codestringThe failure code for failed executions.
source_accountobjectrequiredguidstringrequiredAuto-generated unique identifier for the transfer account.
typestringrequiredThe type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.
organization_guidstringThe account's organization identifier.
bank_guidstringThe account's bank identifier.
customer_guidstringThe account's customer identifier.
counterparty_guidstringThe account's counterparty identifier.
assetstringrequiredThe account asset, e.g., USD.
requested_amountintegerThe requested amount in base units intended to transfer from or to the account.
quoted_amountintegerThe quoted amount in base units to transfer from or to the account.
executed_amountintegerThe executed amount in base units transferred from or to the account.
payment_railach | eft | wire | rtp | etransferThe desired payment rail to use to initiate a fiat transfer.
destination_accountobjectrequiredguidstringrequiredAuto-generated unique identifier for the transfer account.
typestringrequiredThe type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.
organization_guidstringThe account's organization identifier.
bank_guidstringThe account's bank identifier.
customer_guidstringThe account's customer identifier.
counterparty_guidstringThe account's counterparty identifier.
assetstringrequiredThe account asset, e.g., USD.
requested_amountintegerThe requested amount in base units intended to transfer from or to the account.
quoted_amountintegerThe quoted amount in base units to transfer from or to the account.
executed_amountintegerThe executed amount in base units transferred from or to the account.
payment_railach | eft | wire | rtp | etransferThe desired payment rail to use to initiate a fiat transfer.
stagesobject[]requiredThe stages of the execution.
feesobject[]requiredThe fees associated with the execution.
holdsobject[]The holds placed on the execution.
travel_rule_infoobjectrequiredThe travel rule information associated with the execution.
originating_partyobjectrequiredreceiving_partyobjectrequiredultimate_originating_partyobjectultimate_receiving_partyobjectpurpose_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_servicesThe 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_stagerequiredThe type of object being referenced; one of returned_execution or returned_stage.
guidstringrequiredThe guid of the referenced object.
Stage
guidstringrequiredThe unique identifier for the stage.
typestringrequiredThe type of stage; one of payout, deposit, withdrawal, trade, deposit_return, loss_recovery, or withdrawal_return.
statestringrequiredThe state of the stage; one of storing, planning, planned, executing, completed, or failed.
failure_codestringThe failure code for failed stages.
identifiersobject[]requiredProvider-issued identifiers associated with this stage. Always present, possibly empty.
linksobject[]requiredProvider-issued links associated with this stage. Always present, possibly empty.
created_atstring<date-time>requiredThe ISO8601 datetime the stage was created at.
updated_atstring<date-time>requiredThe ISO8601 datetime the stage was last updated at.
source_accountobjectrequiredguidstringrequiredAuto-generated unique identifier for the transfer account.
typestringrequiredThe type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.
organization_guidstringThe account's organization identifier.
bank_guidstringThe account's bank identifier.
customer_guidstringThe account's customer identifier.
counterparty_guidstringThe account's counterparty identifier.
assetstringrequiredThe account asset, e.g., USD.
requested_amountintegerThe requested amount in base units intended to transfer from or to the account.
quoted_amountintegerThe quoted amount in base units to transfer from or to the account.
executed_amountintegerThe executed amount in base units transferred from or to the account.
payment_railach | eft | wire | rtp | etransferThe desired payment rail to use to initiate a fiat transfer.
destination_accountobjectrequiredguidstringrequiredAuto-generated unique identifier for the transfer account.
typestringrequiredThe type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.
organization_guidstringThe account's organization identifier.
bank_guidstringThe account's bank identifier.
customer_guidstringThe account's customer identifier.
counterparty_guidstringThe account's counterparty identifier.
assetstringrequiredThe account asset, e.g., USD.
requested_amountintegerThe requested amount in base units intended to transfer from or to the account.
quoted_amountintegerThe quoted amount in base units to transfer from or to the account.
executed_amountintegerThe executed amount in base units transferred from or to the account.
payment_railach | eft | wire | rtp | etransferThe desired payment rail to use to initiate a fiat transfer.
feesobject[]requiredThe fees associated with the stage.
deposit_return_detailsobjectreturned_atstring<date-time>requiredThe timestamp when the return was initiated by the provider.
return_codestringThe ACH/EFT return code (e.g. R01, R10) received from the provider. Absent when the provider did not report a return code.
withdrawal_return_detailsobjectreturned_atstring<date-time>requiredThe timestamp when the return was initiated by the provider.
return_codestringThe ACH/EFT return code (e.g. R01, R10) received from the provider. Absent when the provider did not report a return code.
StageIdentifier
typestringrequiredThe kind of identifier.
valuestringrequiredThe identifier value as issued by the rail.
StageLink
typestringrequiredThe kind of link.
valuestringrequiredThe URL.
ReturnDetails
returned_atstring<date-time>requiredThe timestamp when the return was initiated by the provider.
return_codestringThe ACH/EFT return code (e.g. R01, R10) received from the provider. Absent when the provider did not report a return code.
FeeAssociation
typestringrequiredThe type of fee; one of platform, network, or bank.
assetstringrequiredThe asset the fee is denominated in, e.g., USD.
quoted_amountintegerrequiredThe quoted amount in base units for the fee.
executed_amountintegerThe executed amount in base units for the fee.
FeeDetail
typebank | platform | networkrequiredThe type of fee; one of bank, platform, or network.
assetstringrequiredThe asset the fee is denominated in, e.g., USD.
amountintegerrequiredThe fee amount in base units of the asset.
HoldDetail
typecustomer_hold_duration | reserve_below_minimum | screening_administrative | screening_non_administrativeThe type of hold; one of customer_hold_duration, reserve_below_minimum, screening_administrative, or screening_non_administrative.
stateactive | completed | storingrequiredThe state of the hold; one of active, completed, or storing
started_atstring<date-time>requiredISO8601 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
guidstringrequiredAuto-generated unique identifier for the transfer account.
typestringrequiredThe type of transfer account; one of trading, fiat, external_bank_account, or external_wallet.
organization_guidstringThe account's organization identifier.
bank_guidstringThe account's bank identifier.
customer_guidstringThe account's customer identifier.
counterparty_guidstringThe account's counterparty identifier.
assetstringrequiredThe account asset, e.g., USD.
requested_amountintegerThe requested amount in base units intended to transfer from or to the account.
quoted_amountintegerThe quoted amount in base units to transfer from or to the account.
executed_amountintegerThe executed amount in base units transferred from or to the account.
payment_railach | eft | wire | rtp | etransferThe desired payment rail to use to initiate a fiat transfer.
TravelRuleInfoParty
typestringrequiredThe type of entity; one of bank, customer, or counterparty.
participant_guidstringrequiredThe unique identifier for the participant.
QuoteEntry
source_accountobjectThe source account in the batch transfer entry.
guidstringAuto-generated unique identifier for the transfer account.
typestringThe type of transfer account; one of external_wallet.
bank_guidstringThe account's identifier.
customer_guidstringThe account's identifier.
destination_accountobjectThe destination account entry in the batch transfer.
guidstringAuto-generated unique identifier for the transfer account.
typestringThe type of transfer account; one of trading, fiat, external_bank_account, external_wallet, one_time_address, reserve, invoice_operations, fee, gas, or storage.
bank_guidstringThe account's identifier.
customer_guidstringThe account's identifier.
receive_amountintegerThe amount to be received in base units of the currency
deliver_amountintegerThe amount to be delivered in base units of the currency
feeintegerThe fee associated with the account entry.
QuoteList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredWorkflow
guidstringAuto-generated unique identifier for the workflow.
bank_guidstringThe associated banks's identifier.
customer_guidstringThe associated customer's identifier.
typestringThe type of workflow; one of plaid.
statestringThe state of the workflow; one of storing, completed, or failed.
failure_codestringThe 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_guidstringrequiredThe unique identifier for the identity verification.
persona_inquiry_idstringrequiredThe unique identifier for the Persona inquiry.
persona_session_tokenstringrequiredThe token to be used in the Persona session.
PostPersonaSession
Request body for persona session creation.
persona_inquiry_idstringrequiredThe ID of the Persona inquiry to create a session for
identity_verification_guidstringrequiredThe GUID of the identity verification associated with the session
SardineSession
guidstringrequiredAuto-generated unique identifier for the sardine session key.
sardine_session_keystringrequiredThe session key to initialize the Sardine SDK with.
customer_guidstringrequiredThe 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_guidstringThe 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
guidstringAuto-generated unique identifier for the transfer.
transfer_typestringThe type of transfer; one of funding, book, crypto, instant_funding, funding_return, crypto_return, loss_recovery, inter_account, lightning, or instant_funding_return.
bank_guidstringThe associated bank's identifier.
customer_guidstringThe associated customer's identifier.
quote_guidstringThe associated quote's identifier.
external_bank_account_guidstringThe associated external bank account's identifier.
assetstringThe asset the transfer is related to, e.g., USD.
sidestringThe direction of the quote; one of deposit or withdrawal.
statestringThe state of the transfer; one of storing, pending, reviewing, completed, or failed.
failure_codestringThe 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_codestringThe return code for reversed transfers
amountintegerThe actual amount in base units of the asset.
estimated_amountintegerThe estimated amount in base units of the asset.
feeintegerThe fee associated with the transfer. Represents the sum of the bank and platform fees.
fee_detailsobject[]The fees associated with the transfer.
estimated_network_feeintegerThe estimated network fee in base units of network_fee_asset. Only present on `crypto` transfers.
network_feeintegerThe actual network fee in base units of network_fee_asset. Only present on `crypto` transfers that have successfully completed.
network_fee_assetstringThe asset code of the network fee. Only present on `crypto` transfers that have successfully completed.
network_fee_liability_amountintegerThe 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_assetstringThe fiat asset the network_fee_liability_amount is denominated in. Only present on `crypto` transfers that have successfully completed.
txn_hashstringThe hash of the blockchain transaction (deprecated: use identifiers array)
identifiersobject[]Array of identifiers associated with this transfer (transaction hash, wire reference numbers)
reference_transfer_guidstringThe guid of the related transfer. Only present on return type transfers.
source_accountobjectThe source account in the transfer. Can be omitted for crypto deposits.
guidstringAuto-generated unique identifier for the transfer account.
typestringThe type of transfer account; one of trading, fiat, external_bank_account, external_wallet, one_time_address, reserve, invoice_operations, fee, gas, or storage.
bank_guidstringThe account's identifier.
customer_guidstringThe account's identifier.
source_participantsobject[]The participants in the source account.
destination_accountobjectThe destination account in the transfer.
guidstringAuto-generated unique identifier for the transfer account.
typestringThe type of transfer account; one of trading, fiat, external_bank_account, external_wallet, one_time_address, reserve, invoice_operations, fee, gas, or storage.
bank_guidstringThe account's identifier.
customer_guidstringThe account's identifier.
destination_participantsobject[]The participants in the source account.
deposit_address_guidstringThe 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_detailsobjectThe 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.
durationintegerThe approximate time (in seconds) that the transfer will be held for.
started_atstring<date-time>ISO8601 datetime the transfer hold was started at.
transfer_detailsobjectThe raw details on the transfer from the bank.
payment_railstringThe rail the payment was done on. One of: ach, eft, wire, rtp, etransfer
external_idstringThe external identifier for the transfer.
labelsstring[]The labels associated with the transfer.
entriesobject[]Transfer entries associated with the batch transfer
TransferEntry
amountintegerrequiredThe actual amount in base units of the asset.
feeintegerrequiredThe fee associated with the transfer entry.
source_accountobjectrequiredThe source account in the batch transfer entry.
guidstringAuto-generated unique identifier for the transfer account.
typestringThe type of transfer account; one of external_wallet.
bank_guidstringThe account's identifier.
customer_guidstringThe account's identifier.
destination_accountobjectrequiredThe destination account entry in the batch transfer.
guidstringAuto-generated unique identifier for the transfer account.
typestringThe type of transfer account; one of trading, fiat, external_bank_account, external_wallet, one_time_address, reserve, invoice_operations, fee, gas, or storage.
bank_guidstringThe account's identifier.
customer_guidstringThe account's identifier.
TransferParticipant
typestringrequiredThe type of participant; one of unknown, bank, customer, or counterparty.
amountintegerrequiredThe amount in base units of the asset.
guidstringThe participant's identifier.
Trade
guidstringAuto-generated unique identifier for the trade.
trade_typestringThe type of trade; one of platform, liquidation, or exit.
customer_guidstringThe associated customer's identifier.
quote_guidstringThe associated quote's identifier.
symbolstringThe trade symbol the pricing is related to. Format is asset-counter_asset, e.g., BTC-USD.
sidestringThe direction of the trade; one of buy or sell.
statestringThe state of the trade; one of storing, pending, cancelled, completed, settling, or failed.
failure_codestringThe failure code for failed trades; one of non_sufficient_funds, unsupported, limit_exceeded, expired_quote, market_volatility, or not_filled.
receive_amountintegerThe amount to be received in base units of the currency: currency is "asset" for buy and "counter_asset" for sell.
deliver_amountintegerThe amount to be delivered in base units of the currency: currency is "counter_asset" for buy and "asset" for sell.
feeintegerThe 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_guidstringThe 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
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredExternalBankAccountList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredTransferList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredTradeList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredWorkflowsList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredAccount
typestringThe account type; one of trading, fee, fiat, gas, reserve, invoice_operations, or storage.
guidstringAuto-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.
assetstringThe asset code.
namestringThe name of the account.
bank_guidstringThe bank identifier associated with the account.
customer_guidstringThe customer identifier associated with the account.
platform_balanceintegerThe amount of funds that are in the account, in base units of the asset.
minimum_balance_funding_pullintegerThe minimum balance for no-hold ACH pulls, in base units of the account asset. Only returned for reserve accounts.
platform_availableintegerThe amount of funds that are in the account, in base units of the asset, that are available for use on the platform.
statestringThe state of the account; one of storing or created.
labelsstring[]The labels associated with the account.
AccountList
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredExternalBankAccount
guidstringAuto-generated unique identifier for the account.
namestringThe name of the account.
assetstringThe asset code.
account_kindstringThe type of account; one of plaid, plaid_processor_token, or raw_routing_details.
environmentstringThe environment that the external bank account is operating in; one of sandbox or production.
bank_guidstringThe bank identifier.
customer_guidstringThe customer identifier.
counterparty_guidstringThe 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_idstringThe Plaid institution ID for the account.
plaid_account_maskstringThe account number mask for the account.
plaid_account_namestringThe name for the account.
statestringThe state of the external bank account; one of storing, completed, failed, refresh_required, unverified, deleting, or deleted.
failure_codestringThe failure code for failed transfers.
balance_updated_atstring<date-time>The timestamp that the balance information was last updated at.
balancesobjectBalance information for the account.
availableintegerThe available balance in the account.
currentintegerThe current balance in the account including pending transactions.
piiobject[]The account holder information.
IdentificationNumber
typestringrequiredThe 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_codestringrequiredThe ISO 3166 country 2-Alpha country code of the identification number issuer.
identification_numberstringrequiredThe identification number.
issuing_subdivisionstringThe ISO 3166-2 subdivision code of the identification number issuer.
ExternalWallet
guidstringAuto-generated unique identifier for the wallet.
namestringThe name of the wallet.
assetstringThe asset code.
environmentstringThe environment that the wallet is configured for; one of sandbox or production.
bank_guidstringThe bank identifier.
customer_guidstringThe customer identifier.
counterparty_guidstringThe counterparty identifier.
addressstringThe blockchain wallet address for the wallet.
tagstringThe 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.
statestringThe state of the external wallet; one of storing, pending, failed, completed, deleting, or deleted.
failure_codestringThe failure code of an external wallet (if any)
PostBank
Request body for bank creation.
typesandboxrequiredThe type of bank.
namestringrequiredThe name of the bank.
supported_trading_symbolsstring[]requiredThe 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[]requiredThe fiat account assets supported by the bank.
supported_country_codesstring[]requiredThe country codes supported by the bank.
featuresstring[]requiredThe features supported by the bank.
cors_allowed_originsstring[]The list of allowed CORS origin URIs.
PatchBank
Request body for bank modification.
namestringThe 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 | individualrequiredThe type of customer.
addressobjectThe customer's address.
streetstringrequiredThe first line of the address.
street2stringThe optional second line of the address.
citystringrequiredThe city of the address.
subdivisionstringThe ISO 3166-2 subdivision code of the address. Applicable only for countries that use subnational states, provinces, lands, oblasts or regions.
postal_codestringThe postal, zip or post code of the address. Applicable only for countries that use postal, zip or post codes.
country_codestringrequiredThe ISO 3166 country 2-Alpha country code of the address.
phone_numberstringThe customer's phone number.
email_addressstringThe customer's email address.
identification_numbersobject[]The customer's identification numbers.
nameobjectThe customer's name. Optional when type is individual or type is business.
firststringThe customer's first name. Required when type is individual.
middlestringThe customer's middle name. Optional when type is individual.
laststringThe customer's last name. Required when type is individual.
fullstringThe 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.
websitestringThe customer's website. Optional when type is business.
labelsstring[]The labels associated with the customer.
PatchCustomer
Request body for customer modification.
stateunverifiedThe customer's state.
PostCounterparty
Request body for counterparty creation.
typebusiness | individualrequiredThe counterparty's type.
customer_guidstringThe owning customer's identifier.
addressobjectrequiredThe address of the counterparty.
streetstringThe first line of the address.
street2stringThe optional second line of the address.
citystringThe city of the address.
subdivisionstringThe ISO 3166-2 subdivision code of the address. Applicable only for countries that use subnational states, provinces, lands, oblasts or regions.
postal_codestringThe postal, zip or post code of the address. Applicable only for countries that use postal, zip or post codes.
country_codestringrequiredThe ISO 3166 country 2-Alpha country code of the address.
nameobjectThe name of the counterparty. Required when type is business or type is individual.
fullstringThe counterparty's full name. Required when type is business.
firststringThe counterparty's first name. Required when type is individual.
middlestringThe counterparty's middle name. Optional when type is individual.
laststringThe 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_addressstringThe 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 | counterpartyrequiredThe type of identity verification.
customer_guidstringThe 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_ownershipThe identity verification method. Required when type is counterparty, type is kyc, or type is bank_account.
counterparty_guidstringThe counterparty's identifier. Required when type is counterparty.
country_codestringThe 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_idbooleanWhether 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.
nameobjectThe 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.
firststringThe 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.
middlestringThe 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.
laststringThe 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.
fullstringThe 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.
addressobjectThe 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.
streetstringThe 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.
street2stringThe 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.
citystringThe 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.
subdivisionstringThe 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_codestringThe 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_codestringThe 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_numberstringThe 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_addressstringThe 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.
websitestringThe 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_businessstringThe 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_addressobjectThe customer's registered address. Required for attested business registration V3. Optional when type is kyc and method is attested_business_registration.
streetstringThe first line of the address. Required when type is kyc and method is attested_business_registration.
street2stringThe optional second line of the address. Optional when type is kyc and method is attested_business_registration.
citystringThe city of the address. Required when type is kyc and method is attested_business_registration.
subdivisionstringThe 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_codestringThe 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_codestringThe ISO 3166 country 2-Alpha country code of the address. Required when type is kyc and method is attested_business_registration.
business_industrystringThe 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_sourcestringThe 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_destinationstringThe 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.
occupationstringThe 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_verifiedbooleanWhether 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_guidstringThe 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_numberrequiredThe source of the identification number.
issuing_country_codestringrequiredThe ISO 3166 country 2-Alpha country code of the identification number issuer.
identification_numberstringrequiredThe identification number.
issuing_subdivisionstringThe ISO 3166-2 subdivision code of the identification number issuer.
PostUltimateBeneficialOwner
Identification number details.
customer_guidstringrequiredThe customer identifier.
ownership_percentagenumberrequiredThe 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_exportrequiredThe type of file.
customer_guidstringrequiredThe customer identifier.
filenamestringrequiredThe name of the file.
content_typeimage/jpeg | image/png | application/pdf | application/json | video/mp4requiredThe content type of the file.
datastringBase64 encoded file content
metadataobjectFile metadata (e.g., {"part": "front"})
partfront | backThe part of the file (e.g., "front", "back")
PostDepositAddress
Request body for deposit address creation.
namestringThe name of the deposit address.
account_guidstringrequiredThe trading account guid.
labelsstring[]The labels associated with the address.
PatchDepositAddress
Request body for deposit address modification.
namestringThe name of the deposit address.
PatchDepositBankAccount
Request body for deposit bank account modification.
namestringThe name of the deposit bank account.
PostSupportedPayoutSymbols
Supported payout symbols details.
primary_assetstringrequiredThe primary asset of the payout symbol, e.g., MXN.
counter_assetstringrequiredThe counter asset of the payout symbol, e.g., USD.
country_codestringrequiredThe ISO 3166 country 2-Alpha country code is permitted in, e.g., MX.
participants_typeC2C | C2B | B2C | B2BrequiredThe participants the symbol is permitted for.
routebank_account | mobile_walletrequiredThe route the symbol is permitted for.
PostAccount
Request body for account creation.
typetrading | fiat | invoice_operations | storagerequiredThe account type.
customer_guidstringThe customer identifier associated with the account.
assetstringrequiredThe asset code.
namestringrequiredThe name of the account.
labelsstring[]The labels associated with the account.
PatchAccount
Request body for account modification.
namestringThe name of the account.
PostWorkflow
Request body for workflow creation.
typeplaidrequiredThe workflow type.
kindlink_token_create | link_token_updateThe Plaid workflow kind. Required when type is plaid.
customer_guidstringThe customer identifier associated with the workflow. Optional when type is plaid and kind is link_token_create.
external_bank_account_guidstringThe external bank account identifier associated with the workflow. Required when type is plaid and kind is link_token_update.
languageen | fr | es | nl | deThe language to initialize Plaid link. Required when type is plaid.
link_customization_namestringThe customization name for Plaid link. For English, use "default". For Spanish, use "spanish_customization". Required when type is plaid.
redirect_uristringThe redirect URI for Plaid link. Optional when type is plaid.
android_package_namestringThe 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 | counterpartyrequiredThe type of participant.
amountintegerrequiredThe amount in base units of the asset.
guidstringrequiredThe participant's identifier.
PostTransfer
Request body for transfer creation.
quote_guidstringrequiredThe associated quote's identifier.
transfer_typefunding | crypto | instant_funding | inter_account | lightning | bookrequiredThe type of transfer.
external_bank_account_guidstringThe 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_guidstringThe 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_guidstringThe 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 | etransferThe desired payment rail to initiate the transfer for. Optional when transfer_type is funding.
beneficiary_memostringThe memo to send to the counterparty. Optional when transfer_type is funding.
security_questionstringThe 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_answerstringThe 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_guidstringThe 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_guidstringThe 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_guidstringThe 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_guidstringThe source account's identifier. Required when transfer_type is book or transfer_type is inter_account.
destination_account_guidstringThe destination account's identifier. Required when transfer_type is book or transfer_type is inter_account.
external_wallet_guidstringThe customer's external wallet's identifier. Optional when transfer_type is crypto.
customer_guidstringThe customer's identifier. Required when transfer_type is lightning.
network_fee_account_guidstringThe 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 | counterpartyrequiredThe type of participant.
amountintegerrequiredThe amount in base units of the asset.
guidstringrequiredThe participant's identifier.
PostTrade
Request body for trade creation.
trade_typeplatformThe type of trade.
quote_guidstringrequiredThe associated quote's identifier.
fiat_account_guidstringThe 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_fundsThe optional expected error to simulate trade failure.
labelsstring[]The labels associated with the trade.
PatchExternalBankAccount
Request body for external bank account modification.
statecompleted | refresh_requiredThe 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.
namestringThe name of the external bank account.
PostExternalBankAccount
Request body for external bank account creation.
namestringrequiredThe name of the account.
account_kindplaid | plaid_processor_token | raw_routing_detailsrequiredThe account type
customer_guidstringThe customer identifier.
assetstringThe asset code. If not set will try and default to the Bank's configured fiat asset.
plaid_public_tokenstringThe public token for the account. Required for 'plaid' accounts. Required when account_kind is plaid.
plaid_account_idstringThe account identifier in plaid. Required for 'plaid' accounts. Required when account_kind is plaid.
plaid_processor_tokenstringThe Plaid processor token used to access the account. Required when account_kind is plaid_processor_token.
plaid_institution_idstringPlaid's institution ID for the account's institution. Required when account_kind is plaid_processor_token.
plaid_account_maskstringThe account mask for the account. Required when account_kind is plaid_processor_token.
plaid_account_namestringThe name of the account. Required when account_kind is plaid_processor_token.
counterparty_guidstringThe counterparty identifier. Optional when account_kind is raw_routing_details.
counterparty_bank_accountobjectThe counterparty's checking bank account information. Required when account_kind is raw_routing_details.
routing_number_typeCPA | ABA | IFSCThe type of routing number. Required when account_kind is raw_routing_details.
routing_numberstringThe routing number. Required when account_kind is raw_routing_details.
account_numberstringThe account number. Required when account_kind is raw_routing_details.
counterparty_nameobjectThe counterparty's name on their checking account. Required when account_kind is raw_routing_details and counterparty_guid is not present.
firststringThe counterparty's first name; used for individuals. Optional when account_kind is raw_routing_details and counterparty_guid is not present.
middlestringThe counterparty's middle name; used for individuals. Optional when account_kind is raw_routing_details and counterparty_guid is not present.
laststringThe counterparty's last name; used for individuals. Optional when account_kind is raw_routing_details and counterparty_guid is not present.
fullstringThe counterparty's full name; used for businesses. Optional when account_kind is raw_routing_details and counterparty_guid is not present.
counterparty_addressobjectThe counterparty's address on their checking account. Required when account_kind is raw_routing_details and counterparty_guid is not present.
streetstringThe first line of the address. Required when account_kind is raw_routing_details and counterparty_guid is not present.
street2stringThe optional second line of the address. Optional when account_kind is raw_routing_details and counterparty_guid is not present.
citystringThe city of the address. Required when account_kind is raw_routing_details and counterparty_guid is not present.
subdivisionstringThe 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_codestringThe 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_codestringThe 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_addressstringThe 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_codestringThe bank code.
account_identifierstringrequiredThe account number or unique identifier for the account.
account_identifier_typeCLABE | PHONE_NUMBER | EMAIL | DEBIT_CARD | CBU | CVU | RANDOM | CPF | CNPJThe 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 | UNSPECIFIEDrequiredThe payment rail used for the account.
bank_code_typeCPA | ABA | CLABE | PIX | CBU_CVU | PSE | IFSC | IBAN | SBP | BEFTN | SWIFT_BIC | CBN | SORT_CODEThe 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 | savingsThe 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.
namestringrequiredName of the external wallet.
customer_guidstringThe customer identifier.
counterparty_guidstringThe counterparty identifier.
assetstringrequiredThe asset code.
addressstringrequiredThe blockchain wallet address for the wallet.
tagstringThe 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.
namestringThe name of the external wallet.
PlatformFile
guidstringThe unique identifier for the file.
organization_guidstringThe organization identifier.
bank_guidstringThe bank identifier.
customer_guidstringThe customer identifier.
typestringThe 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_typestringThe media type; one of image/jpeg, image/png, application/pdf, application/json, or video/mp4.
filenamestringThe 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 | failedThe state of the file. One of storing, completed, or failed.
failure_codestringThe 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
totalintegerrequiredThe total number of records available.
pageintegerrequiredThe page index to retrieve.
per_pageintegerrequiredThe number of entities per page to return.
objectsobject[]requiredErrorResponse
statusintegerrequiredStatus code for Http Request
error_messagestringrequiredError message
message_codestringrequiredMessage code for Error