Creates an Account Token.
Learn more about calling API v2 endpoints.Parameters
- identityobjectRequired
Information about the company, individual, and business represented by the Account.
- identity.
attestationsobject Attestations from the identity’s key people, e.g. owners, executives, directors, representatives.
- identity.
attestations. directorship_ declarationobject This hash is used to attest that the directors information provided to Stripe is both current and correct; IP, date, and User Agent are expanded by Stripe.
- identity.
attestations. directorship_declaration. attestedboolean A boolean indicating if the directors information has been attested.
- identity.
attestations. ownership_ declarationobject This hash is used to attest that the beneficial owner information provided to Stripe is both current and correct; IP, date, and User Agent are expanded by Stripe.
- identity.
attestations. ownership_declaration. attestedboolean A boolean indicating if the beneficial owner information has been attested.
- identity.
attestations. persons_ providedobject Attestation that all Persons with a specific Relationship value have been provided.
- identity.
attestations. persons_provided. directorsboolean Whether the company’s directors have been provided. Set this Boolean to true after creating all the company’s directors with the Persons API.
- identity.
attestations. persons_provided. executivesboolean Whether the company’s executives have been provided. Set this Boolean to true after creating all the company’s executives with the Persons API.
- identity.
attestations. persons_provided. ownersboolean Whether the company’s owners have been provided. Set this Boolean to true after creating all the company’s owners with the Persons API.
- identity.
attestations. persons_provided. ownership_ exemption_ reasonenum Reason for why the company is exempt from providing ownership information.
Possible enum valuesqualified_entity_ exceeds_ ownership_ threshold A qualifying entity or group of qualifying entities own a significant enough share of the merchant’s business that they are exempt from providing ownership information based on regulatory guidelines in the merchant’s country.
qualifies_as_ financial_ institution A merchant is a financial institution.
- identity.
attestations. representative_ declarationobject This hash is used to attest that the representative is authorized to act as the representative of their legal entity; IP, date, and User Agent are expanded by Stripe.
- identity.
attestations. representative_declaration. attestedboolean A boolean indicating if the representative is authorized to act as the representative of their legal entity.
- identity.
attestations. terms_ of_ serviceobject Attestations of accepted terms of service agreements.
- identity.
attestations. terms_of_service. accountobject Details on the Account’s acceptance of the [Stripe Services Agreement]; IP, date, and User Agent are expanded by Stripe.
- identity.
attestations. terms_of_service. account. shown_ and_ acceptedboolean The boolean value indicating if the terms of service have been accepted.
- identity.
attestations. terms_of_service. storerobjectPreview feature Details on the Account’s acceptance of Treasury-specific terms of service; IP, date, and User Agent are expanded by Stripe.
- identity.
attestations. terms_of_service. storer. shown_ and_ acceptedboolean The boolean value indicating if the terms of service have been accepted.
- identity.
business_ detailsobject Information about the company or business.
- identity.
business_details. addressobject The business registration address of the business entity.
- identity.
business_details. address. citystring City, district, suburb, town, or village.
- identity.
business_details. address. countryenum Two-letter country code (ISO 3166-1 alpha-2).
- identity.
business_details. address. line1string Address line 1 (e.g., street, PO Box, or company name).
- identity.
business_details. address. line2string Address line 2 (e.g., apartment, suite, unit, or building).
- identity.
business_details. address. postal_ codestring ZIP or postal code.
- identity.
business_details. address. statestring State, county, province, or region.
- identity.
business_details. address. townstring Town or cho-me.
- identity.
business_details. annual_ revenueobject The business gross annual revenue for its preceding fiscal year.
- identity.
business_details. annual_revenue. amountobject A non-negative integer representing the amount in the smallest currency unit.
- identity.
business_details. annual_revenue. amount. currencystringRequired A lowercase alpha3 currency code like “usd”.
- identity.
business_details. annual_revenue. amount. valueintegerRequired In minor units like 123 for 1.23 USD.
- identity.
business_details. annual_revenue. fiscal_ year_ endstring The close-out date of the preceding fiscal year in ISO 8601 format. E.g. 2023-12-31 for the 31st of December, 2023.
- identity.
business_details. documentsobject A document verifying the business.
- identity.
business_details. documents. bank_ account_ ownership_ verificationobject One or more documents that support the bank account ownership verification requirement. Must be a document associated with the account’s primary active bank account that displays the last 4 digits of the account number, either a statement or a check.
- identity.
business_details. documents. bank_account_ownership_verification. filesarray of stringsRequired One or more document IDs returned by a file upload with a purpose value of
account_.requirement - identity.
business_details. documents. bank_account_ownership_verification. typeenumRequired The format of the document. Currently supports
filesonly.Possible enum valuesfilesDocument type with multiple files.
- identity.
business_details. documents. company_ licenseobject One or more documents that demonstrate proof of a company’s license to operate.
- identity.
business_details. documents. company_license. filesarray of stringsRequired One or more document IDs returned by a file upload with a purpose value of
account_.requirement - identity.
business_details. documents. company_license. typeenumRequired The format of the document. Currently supports
filesonly.Possible enum valuesfilesDocument type with multiple files.
- identity.
business_details. documents. company_ memorandum_ of_ associationobject One or more documents showing the company’s Memorandum of Association.
- identity.
business_details. documents. company_memorandum_of_association. filesarray of stringsRequired One or more document IDs returned by a file upload with a purpose value of
account_.requirement - identity.
business_details. documents. company_memorandum_of_association. typeenumRequired The format of the document. Currently supports
filesonly.Possible enum valuesfilesDocument type with multiple files.
- identity.
business_details. documents. company_ ministerial_ decreeobject Certain countries only: One or more documents showing the ministerial decree legalizing the company’s establishment.
- identity.
business_details. documents. company_ministerial_decree. filesarray of stringsRequired One or more document IDs returned by a file upload with a purpose value of
account_.requirement - identity.
business_details. documents. company_ministerial_decree. typeenumRequired The format of the document. Currently supports
filesonly.Possible enum valuesfilesDocument type with multiple files.
- identity.
business_details. documents. company_ registration_ verificationobject One or more documents that demonstrate proof of a company’s registration with the appropriate local authorities.
- identity.
business_details. documents. company_registration_verification. filesarray of stringsRequired One or more document IDs returned by a file upload with a purpose value of
account_.requirement - identity.
business_details. documents. company_registration_verification. typeenumRequired The format of the document. Currently supports
filesonly.Possible enum valuesfilesDocument type with multiple files.
- identity.
business_details. documents. company_ tax_ id_ verificationobject One or more documents that demonstrate proof of a company’s tax ID.
- identity.
business_details. documents. company_tax_id_verification. filesarray of stringsRequired One or more document IDs returned by a file upload with a purpose value of
account_.requirement - identity.
business_details. documents. company_tax_id_verification. typeenumRequired The format of the document. Currently supports
filesonly.Possible enum valuesfilesDocument type with multiple files.
- identity.
business_details. documents. primary_ verificationobject A document verifying the business.
- identity.
business_details. documents. primary_verification. front_ backobjectRequired The file upload tokens referring to each side of the document.
- identity.
business_details. documents. primary_verification. front_back. backstring A file upload token representing the back of the verification document. The purpose of the uploaded file should be ‘identity_document’. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.
- identity.
business_details. documents. primary_verification. front_back. frontstring A file upload token representing the front of the verification document. The purpose of the uploaded file should be ‘identity_document’. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.
- identity.
business_details. documents. primary_verification. typeenumRequired The format of the verification document. Currently supports
front_only.back Possible enum valuesfront_back Document type with both front and back sides.
- identity.
business_details. documents. proof_ of_ addressobject One or more documents that demonstrate proof of address.
- identity.
business_details. documents. proof_of_address. filesarray of stringsRequired One or more document IDs returned by a file upload with a purpose value of
account_.requirement - identity.
business_details. documents. proof_of_address. typeenumRequired The format of the document. Currently supports
filesonly.Possible enum valuesfilesDocument type with multiple files.
- identity.
business_details. documents. proof_ of_ registrationobject One or more documents showing the company’s proof of registration with the national business registry.
- identity.
business_details. documents. proof_of_registration. filesarray of stringsRequired One or more document IDs returned by a file upload with a purpose value of
account_.requirement - identity.
business_details. documents. proof_of_registration. typeenumRequired The format of the document. Currently supports
filesonly.Possible enum valuesfilesDocument type with multiple files.
- identity.
business_details. documents. proof_ of_ ultimate_ beneficial_ ownershipobject One or more documents that demonstrate proof of ultimate beneficial ownership.
- identity.
business_details. documents. proof_of_ultimate_beneficial_ownership. filesarray of stringsRequired One or more document IDs returned by a file upload with a purpose value of
account_.requirement - identity.
business_details. documents. proof_of_ultimate_beneficial_ownership. typeenumRequired The format of the document. Currently supports
filesonly.Possible enum valuesfilesDocument type with multiple files.
- identity.
business_details. estimated_ worker_ countinteger An estimated upper bound of employees, contractors, vendors, etc. currently working for the business.
- identity.
business_details. id_ numbersarray of objects The ID numbers of a business entity.
- identity.
business_details. id_numbers. registrarstring The registrar of the ID number (Only valid for DE ID number types).
- identity.
business_details. id_numbers. typeenumRequired The ID number type of a business entity.
Possible enum valuesae_crn Company registration number - United Arab Emirates.
ae_vat Business VAT ID - United Arab Emirates.
ao_nif Número de Identificação Fiscal (NIF) - Angola.
ar_cuit Clave Única de Identificación Tributaria - Argentina.
at_fn Firmenbuchnummer - Austria.
au_abn Australian Business Number - Australia.
au_acn Australian Company Number - Australia.
au_in Incorporation Number - Australia.
az_tin Tax Identification Number - Azerbaijan.
bd_etin Electronic Tax Identification Number (ETIN) - Bangladesh.
Show 63 more - identity.
business_details. id_numbers. valuestringRequired The value of the ID number.
- identity.
business_details. monthly_ estimated_ revenueobject An estimate of the monthly revenue of the business.
- identity.
business_details. monthly_estimated_revenue. amountobject A non-negative integer representing the amount in the smallest currency unit.
- identity.
business_details. monthly_estimated_revenue. amount. currencystringRequired A lowercase alpha3 currency code like “usd”.
- identity.
business_details. monthly_estimated_revenue. amount. valueintegerRequired In minor units like 123 for 1.23 USD.
- identity.
business_details. phonestring The phone number of the Business Entity.
- identity.
business_details. registered_ namestring The business legal name.
- identity.
business_details. script_ addressesobject The business registration address of the business entity in non latin script.
- identity.
business_details. script_addresses. kanaobject Kana Address.
- identity.
business_details. script_addresses. kana. citystring City, district, suburb, town, or village.
- identity.
business_details. script_addresses. kana. countryenum Two-letter country code (ISO 3166-1 alpha-2).
- identity.
business_details. script_addresses. kana. line1string Address line 1 (e.g., street, PO Box, or company name).
- identity.
business_details. script_addresses. kana. line2string Address line 2 (e.g., apartment, suite, unit, or building).
- identity.
business_details. script_addresses. kana. postal_ codestring ZIP or postal code.
- identity.
business_details. script_addresses. kana. statestring State, county, province, or region.
- identity.
business_details. script_addresses. kana. townstring Town or cho-me.
- identity.
business_details. script_addresses. kanjiobject Kanji Address.
- identity.
business_details. script_addresses. kanji. citystring City, district, suburb, town, or village.
- identity.
business_details. script_addresses. kanji. countryenum Two-letter country code (ISO 3166-1 alpha-2).
- identity.
business_details. script_addresses. kanji. line1string Address line 1 (e.g., street, PO Box, or company name).
- identity.
business_details. script_addresses. kanji. line2string Address line 2 (e.g., apartment, suite, unit, or building).
- identity.
business_details. script_addresses. kanji. postal_ codestring ZIP or postal code.
- identity.
business_details. script_addresses. kanji. statestring State, county, province, or region.
- identity.
business_details. script_addresses. kanji. townstring Town or cho-me.
- identity.
business_details. script_ namesobject The business legal name in non latin script.
- identity.
business_details. script_names. kanaobject Kana name.
- identity.
business_details. script_names. kana. registered_ namestring Registered name of the business.
- identity.
business_details. script_names. kanjiobject Kanji name.
- identity.
business_details. script_names. kanji. registered_ namestring Registered name of the business.
- identity.
business_details. structureenum The category identifying the legal structure of the business.
Possible enum valuescooperativeA cooperative organization.
free_zone_ establishment A free zone establishment.
free_zone_ llc A free zone LLC.
government_instrumentality An organization formed by a government statute or body based in the US to perform a certain function, but not the actual government body itself.
governmental_unit A branch of the state, local, or federal government of the US.
incorporated_association An incorporated association.
incorporated_non_ profit An organization incorporated under the laws of a US state that has obtained tax-exempt status as a non-profit entity under either state or federal law (for example, 501©(3)).
incorporated_partnership Also called ‘Limited Partnerships’ or ‘Registered Ordinary Partnerships’, these are businesses registered in Thailand owned by two or more people. The business’ legal entity and its legal personality is separated and distinct from the individual partners.
limited_liability_ partnership A limited liability partnership.
llcAn LLC.
Show 17 more
- identity.
entity_ typeenum The entity type.
Possible enum valuescompanyA registered business.
government_entity Government entity.
individualAn individual that is not registered as a business.
non_profit A Non profit organization.
- identity.
individualobject Information about the person represented by the account.
- identity.
individual. additional_ addressesarray of objects Additional addresses associated with the individual.
- identity.
individual. additional_addresses. citystring City, district, suburb, town, or village.
- identity.
individual. additional_addresses. countryenum Two-letter country code (ISO 3166-1 alpha-2).
- identity.
individual. additional_addresses. line1string Address line 1 (e.g., street, PO Box, or company name).
- identity.
individual. additional_addresses. line2string Address line 2 (e.g., apartment, suite, unit, or building).
- identity.
individual. additional_addresses. postal_ codestring ZIP or postal code.
- identity.
individual. additional_addresses. purposeenumRequired Purpose of additional address.
Possible enum valuesregisteredRegistered.
- identity.
individual. additional_addresses. statestring State, county, province, or region.
- identity.
individual. additional_addresses. townstring Town or cho-me.
- identity.
individual. additional_ namesarray of objects Additional names (e.g. aliases) associated with the individual.
- identity.
individual. additional_names. full_ namestring The person’s full name.
- identity.
individual. additional_names. given_ namestring The person’s first or given name.
- identity.
individual. additional_names. purposeenumRequired The purpose or type of the additional name.
Possible enum valuesaliasAn alias for the individual’s name.
maidenThe maiden name of the individual.
- identity.
individual. additional_names. surnamestring The person’s last or family name.
- identity.
individual. addressobject The individual’s residential address.
- identity.
individual. address. citystring City, district, suburb, town, or village.
- identity.
individual. address. countryenum Two-letter country code (ISO 3166-1 alpha-2).
- identity.
individual. address. line1string Address line 1 (e.g., street, PO Box, or company name).
- identity.
individual. address. line2string Address line 2 (e.g., apartment, suite, unit, or building).
- identity.
individual. address. postal_ codestring ZIP or postal code.
- identity.
individual. address. statestring State, county, province, or region.
- identity.
individual. address. townstring Town or cho-me.
- identity.
individual. date_ of_ birthobject The individual’s date of birth.
- identity.
individual. date_of_birth. dayintegerRequired The day of the birth.
- identity.
individual. date_of_birth. monthintegerRequired The month of birth.
- identity.
individual. date_of_birth. yearintegerRequired The year of birth.
- identity.
individual. documentsobject Documents that may be submitted to satisfy various informational requests.
- identity.
individual. documents. object One or more documents that demonstrate proof that this person is authorized to represent the company.
- identity.
individual. documents. company_authorization. array of stringsRequired One or more document IDs returned by a file upload with a purpose value of
account_.requirement - identity.
individual. documents. company_authorization. enumRequired The format of the document. Currently supports
filesonly.Possible enum valuesfilesDocument type with multiple files.
- identity.
individual. documents. passportobject One or more documents showing the person’s passport page with photo and personal data.
- identity.
individual. documents. passport. filesarray of stringsRequired One or more document IDs returned by a file upload with a purpose value of
account_.requirement - identity.
individual. documents. passport. typeenumRequired The format of the document. Currently supports
filesonly.Possible enum valuesfilesDocument type with multiple files.
- identity.
individual. documents. primary_ verificationobject An identifying document showing the person’s name, either a passport or local ID card.
- identity.
individual. documents. primary_verification. front_ backobjectRequired The file upload tokens referring to each side of the document.
- identity.
individual. documents. primary_verification. front_back. backstring A file upload token representing the back of the verification document. The purpose of the uploaded file should be ‘identity_document’. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.
- identity.
individual. documents. primary_verification. front_back. frontstring A file upload token representing the front of the verification document. The purpose of the uploaded file should be ‘identity_document’. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.
- identity.
individual. documents. primary_verification. typeenumRequired The format of the verification document. Currently supports
front_only.back Possible enum valuesfront_back Document type with both front and back sides.
- identity.
individual. documents. secondary_ verificationobject A document showing address, either a passport, local ID card, or utility bill from a well-known utility company.
- identity.
individual. documents. secondary_verification. front_ backobjectRequired The file upload tokens referring to each side of the document.
- identity.
individual. documents. secondary_verification. front_back. backstring A file upload token representing the back of the verification document. The purpose of the uploaded file should be ‘identity_document’. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.
- identity.
individual. documents. secondary_verification. front_back. frontstring A file upload token representing the front of the verification document. The purpose of the uploaded file should be ‘identity_document’. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.
- identity.
individual. documents. secondary_verification. typeenumRequired The format of the verification document. Currently supports
front_only.back Possible enum valuesfront_back Document type with both front and back sides.
- identity.
individual. documents. visaobject One or more documents showing the person’s visa required for living in the country where they are residing.
- identity.
individual. documents. visa. filesarray of stringsRequired One or more document IDs returned by a file upload with a purpose value of
account_.requirement - identity.
individual. documents. visa. typeenumRequired The format of the document. Currently supports
filesonly.Possible enum valuesfilesDocument type with multiple files.
- identity.
individual. emailstring The individual’s email address.
- identity.
individual. given_ namestring The individual’s first name.
- identity.
individual. id_ numbersarray of objects The identification numbers (e.g., SSN) associated with the individual.
- identity.
individual. id_numbers. typeenumRequired The ID number type of an individual.
Possible enum valuesae_eid Emirates ID - United Arab Emirates.
ao_nif Número de Identificação Fiscal (Tax Identification Number) - Angola.
ar_dni Documento Nacional de Identidad (DNI) - Argentina.
az_tin Tax Identification Number - Azerbaijan.
bd_brc Birth Registration Certificate (BRC) - Bangladesh.
bd_etin Electronic Tax Identification Number (ETIN) - Bangladesh.
bd_nid National Identification Number (NID) - Bangladesh.
br_cpf Cadastro de Pessoas Físicas - Brazil.
cr_cpf Cédula de Persona Fisica (CPF) - Costa Rica.
cr_dimex Documento de identificación Tributario Especial (DIMEX) - Costa Rica.
Show 22 more - identity.
individual. id_numbers. valuestringRequired The value of the ID number.
- identity.
individual. legal_ genderenum The individual’s gender (International regulations require either “male” or “female”).
Possible enum valuesfemaleFemale person gender.
maleMale person gender.
- identity.
individual. metadatamap Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- identity.
individual. nationalitiesarray of enums The countries where the individual is a national. Two-letter country code (ISO 3166-1 alpha-2).
- identity.
individual. phonestring The individual’s phone number.
- identity.
individual. political_ exposureenum The individual’s political exposure.
Possible enum valuesexistingThe person has disclosed that they do have political exposure.
noneThe person has disclosed that they have no political exposure.
- identity.
individual. relationshipobject The relationship that this individual has with the account’s identity.
- identity.
individual. relationship. directorboolean Whether the person is a director of the account’s identity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.
- identity.
individual. relationship. executiveboolean Whether the person has significant responsibility to control, manage, or direct the organization.
- identity.
individual. relationship. ownerboolean Whether the person is an owner of the account’s identity.
- identity.
individual. relationship. percent_ ownershipdecimal The percent owned by the person of the account’s legal entity.
- identity.
individual. relationship. titlestring The person’s title (e.g., CEO, Support Engineer).
- identity.
individual. script_ addressesobject The script addresses (e.g., non-Latin characters) associated with the individual.
- identity.
individual. script_addresses. kanaobject Kana Address.
- identity.
individual. script_addresses. kana. citystring City, district, suburb, town, or village.
- identity.
individual. script_addresses. kana. countryenum Two-letter country code (ISO 3166-1 alpha-2).
- identity.
individual. script_addresses. kana. line1string Address line 1 (e.g., street, PO Box, or company name).
- identity.
individual. script_addresses. kana. line2string Address line 2 (e.g., apartment, suite, unit, or building).
- identity.
individual. script_addresses. kana. postal_ codestring ZIP or postal code.
- identity.
individual. script_addresses. kana. statestring State, county, province, or region.
- identity.
individual. script_addresses. kana. townstring Town or cho-me.
- identity.
individual. script_addresses. kanjiobject Kanji Address.
- identity.
individual. script_addresses. kanji. citystring City, district, suburb, town, or village.
- identity.
individual. script_addresses. kanji. countryenum Two-letter country code (ISO 3166-1 alpha-2).
- identity.
individual. script_addresses. kanji. line1string Address line 1 (e.g., street, PO Box, or company name).
- identity.
individual. script_addresses. kanji. line2string Address line 2 (e.g., apartment, suite, unit, or building).
- identity.
individual. script_addresses. kanji. postal_ codestring ZIP or postal code.
- identity.
individual. script_addresses. kanji. statestring State, county, province, or region.
- identity.
individual. script_addresses. kanji. townstring Town or cho-me.
- identity.
individual. script_ namesobject The individuals primary name in non latin script.
- identity.
individual. script_names. kanaobject Persons name in kana script.
- identity.
individual. script_names. kana. given_ namestring The person’s first or given name.
- identity.
individual. script_names. kana. surnamestring The person’s last or family name.
- identity.
individual. script_names. kanjiobject Persons name in kanji script.
- identity.
individual. script_names. kanji. given_ namestring The person’s first or given name.
- identity.
individual. script_names. kanji. surnamestring The person’s last or family name.
- identity.
individual. surnamestring The individual’s last name.
- contact_
emailstring The default contact email address for the Account. Required when configuring the account as a merchant or recipient.
- display_
namestring A descriptive name for the Account. This name will be surfaced in the Stripe Dashboard and on any invoices sent to the Account.
Returns
Response attributes
- idstring
Unique identifier for the token.
- objectstring, value is "v2.core.account_token"
String representing the object’s type. Objects of the same type share the same value of the object field.
- createdtimestamp
Time at which the token was created. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.
- expires_
attimestamp Time at which the token will expire.
- livemodeboolean
Has the value
trueif the token exists in live mode or the valuefalseif the object exists in test mode. - usedboolean
Determines if the token has already been used (tokens can only be used once).
Token must be created with publishable key.
{ "id": "accttok_61RS0CgWt1xBt8M1Q16RS0Cg0WSQO5ZXUVpZxZ9tAIbY", "object": "v2.core.account_token", "created": "2025-11-17T14:00:00.000Z", "expires_at": "2025-11-17T14:10:00.000Z", "livemode": true, "used": false}- Need help? Contact Support.
- Check out our changelog.
- Questions? Contact Sales.
- LLM? Read llms.txt.
- Powered by Markdoc