Skip to content

Shared

Shared

Last updated: (timestamp)

Shared

$shared
Domain Types
Account Financial Account Type
AccountFinancialAccountTypeenum

Type of account financial account

ShowShow
"ISSUING"
"OPERATING"
Address
Addressobject
ShowShow
address1string

Valid deliverable address (no PO boxes).

citystring

Name of city.

countrystring

Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character format. Only USA is currently supported for all workflows. KYC_EXEMPT supports CAN additionally.

postal_codestring

Valid postal code. USA postal codes (ZIP codes) are supported, entered as a five-digit postal code or nine-digit postal code (ZIP+4) using the format 12345-1234. KYC_EXEMPT supports Canadian postal codes.

statestring

Valid state code. USA state codes are supported, entered in uppercase ISO 3166-2 two-character format. KYC_EXEMPT supports Canadian province codes.

address2string
optional

Unit or apartment number (if applicable).

Carrier
Carrierobject
ShowShow
qr_code_urlstring
optional

QR code url to display on the card carrier

Currency
Currencystring

3-character alphabetic ISO 4217 currency

Document
Documentobject

Describes the document and the required document image uploads required to re-run KYC

ShowShow
tokenstring

Globally unique identifier for the document.

formatuuid
account_holder_tokenstring

Globally unique identifier for the account holder.

formatuuid
document_typeenum
Accepts one of the following: "DRIVERS_LICENSE", "PASSPORT", "PASSPORT_CARD", 16 more

Type of documentation to be submitted for verification of an account holder

Hide ParametersShow Parameters
"DRIVERS_LICENSE"
"PASSPORT"
"PASSPORT_CARD"
"EIN_LETTER"
"TAX_RETURN"
"OPERATING_AGREEMENT"
"CERTIFICATE_OF_FORMATION"
"CERTIFICATE_OF_GOOD_STANDING"
"ARTICLES_OF_INCORPORATION"
"ARTICLES_OF_ORGANIZATION"
"BYLAWS"
"GOVERNMENT_BUSINESS_LICENSE"
"PARTNERSHIP_AGREEMENT"
"SS4_FORM"
"BANK_STATEMENT"
"UTILITY_BILL_STATEMENT"
"SSN_CARD"
"ITIN_LETTER"
"FINCEN_BOI_REPORT"
entity_tokenstring

Globally unique identifier for an entity.

formatuuid
required_document_uploadsarray of object

Represents a single image of the document to upload.

Hide ParametersShow Parameters
tokenstring

Globally unique identifier for the document upload.

formatuuid
accepted_entity_status_reasonsarray of string

A list of status reasons associated with a KYB account holder that have been satisfied by the document upload

createdstring

When the document upload was created

formatdate-time
image_typeenum
Accepts one of the following: "FRONT", "BACK"

Type of image to upload.

Hide ParametersShow Parameters
"FRONT"
"BACK"
rejected_entity_status_reasonsarray of string

A list of status reasons associated with a KYB account holder that have not been satisfied by the document upload

statusenum
Accepts one of the following: "ACCEPTED", "REJECTED", "PENDING_UPLOAD", 2 more

Status of an account holder's document upload.

Hide ParametersShow Parameters
"ACCEPTED"
"REJECTED"
"PENDING_UPLOAD"
"UPLOADED"
"PARTIAL_APPROVAL"
status_reasonsarray of enum

Reasons for document image upload status.

Hide ParametersShow Parameters
"DOCUMENT_MISSING_REQUIRED_DATA"
"DOCUMENT_UPLOAD_TOO_BLURRY"
"FILE_SIZE_TOO_LARGE"
"INVALID_DOCUMENT_TYPE"
"INVALID_DOCUMENT_UPLOAD"
"INVALID_ENTITY"
"DOCUMENT_EXPIRED"
"DOCUMENT_ISSUED_GREATER_THAN_30_DAYS"
"DOCUMENT_TYPE_NOT_SUPPORTED"
"UNKNOWN_FAILURE_REASON"
"UNKNOWN_ERROR"
updatedstring

When the document upload was last updated

formatdate-time
upload_urlstring

URL to upload document image to.

Note that the upload URLs expire after 7 days. If an upload URL expires, you can refresh the URLs by retrieving the document upload from GET /account_holders/{account_holder_token}/documents.

Instance Financial Account Type
InstanceFinancialAccountTypeenum

Type of instance financial account

ShowShow
"ISSUING"
"RESERVE"
"OPERATING"
"CHARGED_OFF_FEES"
"CHARGED_OFF_INTEREST"
"CHARGED_OFF_PRINCIPAL"
"SECURITY"
"PROGRAM_RECEIVABLES"
"COLLECTION"
Shipping Address
ShippingAddressobject
ShowShow
address1string

Valid USPS routable address.

maxLength40
minLength1
citystring

City

maxLength30
minLength1
countrystring

Uppercase ISO 3166-1 alpha-3 three character abbreviation.

maxLength3
minLength3
first_namestring

Customer's first name. This will be the first name printed on the physical card. The combined length of first_name and last_name may not exceed 25 characters.

maxLength24
minLength1
last_namestring

Customer's surname (family name). This will be the last name printed on the physical card. The combined length of first_name and last_name may not exceed 25 characters.

maxLength24
minLength1
postal_codestring

Postal code (formerly zipcode). For US addresses, either five-digit postal code or nine-digit postal code (ZIP+4) using the format 12345-1234.

maxLength12
minLength1
statestring

Uppercase ISO 3166-2 two character abbreviation for US and CA. Optional with a limit of 24 characters for other countries.

maxLength24
minLength0
address2string
optional

Unit number (if applicable).

maxLength40
minLength1
emailstring
optional

Email address to be contacted for expedited shipping process purposes. Required if shipping_method is EXPEDITED.

maxLength50
minLength5
line2_textstring
optional

Text to be printed on line two of the physical card. Use of this field requires additional permissions.

maxLength26
minLength0
phone_numberstring
optional

Cardholder's phone number in E.164 format to be contacted for expedited shipping process purposes. Required if shipping_method is EXPEDITED.

maxLength16
minLength8