Skip to main content
Manja / Stripe
Schema2020-08-27object

tax_id

You can add one or multiple tax IDs to a [customer](https://stripe.com/docs/api/customers). A customer's tax IDs are displayed on invoices and credit notes issued for the customer. Related guide: [Customer Tax Identification Numbers](https://stripe.com/docs/billing/taxes/tax-ids).

Source
openapi/spec3.json
Commit
d70de345383d
Active snapshot
da69df7e6e11
country string
optionalnullable

Two-letter ISO code representing the country of the tax ID.

maxLength:5000

created integer (unix-time)
required

Time at which the object was created. Measured in seconds since the Unix epoch.

customer
optionalnullable

ID of the customer.

id string
required

Unique identifier for the object.

maxLength:5000

livemode boolean
required

Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

object string
required

String representing the object's type. Objects of the same type share the same value.

Allowed: "tax_id"

type string
required

Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `id_npwp`, `il_vat`, `in_gst`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`. Note that some legacy tax IDs have type `unknown`

Allowed: "ae_trn""au_abn""au_arn""br_cnpj""br_cpf""ca_bn""ca_gst_hst""ca_pst_bc""ca_pst_mb""ca_pst_sk""ca_qst""ch_vat""cl_tin""es_cif""eu_vat""gb_vat""ge_vat""hk_br""id_npwp""il_vat""in_gst""jp_cn""jp_rn""kr_brn""li_uid""mx_rfc""my_frp""my_itn""my_sst""no_vat""nz_gst""ru_inn""ru_kpp""sa_vat""sg_gst""sg_uen""th_vat""tw_vat""ua_vat""unknown""us_ein""za_vat"

value string
required

Value of the tax ID.

maxLength:5000

verification
optionalnullable

Tax ID verification information.