Stripe: Tax ids schemas

4 Stripe schemas with complete fields and constraints.

Create a tax ID — response body

Field	Type	Presence	Description and constraints
`$`	object	Root	You can add one or multiple tax IDs to a [customer](https://docs.stripe.com/api/customers) or account. Customer and account tax IDs get displayed on related invoices and credit notes. Related guides: [Customer tax identification numbers](https://docs.stripe.com/billing/taxes/tax-ids), [Account tax IDs](https://docs.stripe.com/invoicing/connect#account-tax-ids)
`country`	JSON	Optional
`country (anyOf 1)`	string	Alternative	Two-letter ISO code representing the country of the tax ID. Maximum length: 5000
`country (anyOf 2)`	null	Alternative
`created`	JSON	Required within parent
`created (anyOf 1)`	integer	Alternative	Time at which the object was created. Measured in seconds since the Unix epoch. Format: unix-time
`created (anyOf 2)`	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
`customer`	JSON	Optional
`customer (anyOf 1)`	JSON	Alternative	ID of the customer.
`customer (anyOf 1) (anyOf 1)`	string	Alternative	Maximum length: 5000
`customer (anyOf 1) (anyOf 2)`	Model	Alternative	Expand Create a customer — response body
`customer (anyOf 2)`	null	Alternative
`customer_account`	JSON	Optional
`customer_account (anyOf 1)`	string	Alternative	ID of the Account representing the customer. Maximum length: 5000
`customer_account (anyOf 2)`	null	Alternative
`id`	string	Required within parent	Unique identifier for the object. Maximum length: 5000
`livemode`	boolean	Required within parent	If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
`object`	string	Required within parent	String representing the object's type. Objects of the same type share the same value. Known values: tax_id
`owner`	JSON	Optional
`owner (anyOf 1)`	JSON	Alternative	The account or customer the tax ID belongs to.
`owner (anyOf 1) (anyOf 1)`	Model	Alternative	Expand Create a tax ID — response body — owner / The account or customer the tax ID belongs to / type: account, application, customer, self
`owner (anyOf 2)`	null	Alternative
`type`	string	Required within parent	Type of the tax ID, one of `ad_nrt`, `ae_trn`, `al_tin`, `am_tin`, `ao_tin`, `ar_cuit`, `au_abn`, `au_arn`, `aw_tin`, `az_tin`, `ba_tin`, `bb_tin`, `bd_bin`, `bf_ifu`, `bg_uic`, `bh_vat`, `bj_ifu`, `bo_tin`, `br_cnpj`, `br_cpf`, `bs_tin`, `by_tin`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cd_nif`, `ch_uid`, `ch_vat`, `cl_tin`, `cm_niu`, `cn_tin`, `co_nit`, `cr_tin`, `cv_nif`, `de_stn`, `do_rcn`, `ec_ruc`, `eg_tin`, `es_cif`, `et_tin`, `eu_oss_vat`, `eu_vat`, `fo_vat`, `gb_vat`, `ge_vat`, `gi_tin`, `gn_nif`, `hk_br`, `hr_oib`, `hu_tin`, `ic_nif`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `it_cf`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kg_tin`, `kh_tin`, `kr_brn`, `kz_bin`, `la_tin`, `li_uid`, `li_vat`, `lk_vat`, `ma_vat`, `md_vat`, `me_pib`, `mk_vat`, `mr_nif`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `ng_tin`, `no_vat`, `no_voec`, `np_pan`, `nz_gst`, `om_vat`, `pe_ruc`, `ph_tin`, `pl_nip`, `py_ruc`, `ro_tin`, `rs_pib`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `sn_ninea`, `sr_fin`, `sv_nit`, `th_vat`, `tj_tin`, `tr_tin`, `tw_vat`, `tz_vat`, `ua_vat`, `ug_tin`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `za_vat`, `zm_tin`, or `zw_tin`. Note that some legacy tax IDs have type `unknown` Known values: ad_nrt, ae_trn, al_tin, am_tin, ao_tin, ar_cuit, au_abn, au_arn, aw_tin, az_tin, ba_tin, bb_tin, bd_bin, bf_ifu, bg_uic, bh_vat, bj_ifu, bo_tin, br_cnpj, br_cpf, bs_tin, by_tin, ca_bn, ca_gst_hst, ca_pst_bc, ca_pst_mb, ca_pst_sk, ca_qst, cd_nif, ch_uid, ch_vat, cl_tin, cm_niu, cn_tin, co_nit, cr_tin, cv_nif, de_stn, do_rcn, ec_ruc, eg_tin, es_cif, et_tin, eu_oss_vat, eu_vat, fo_vat, gb_vat, ge_vat, gi_tin, gn_nif, hk_br, hr_oib, hu_tin, ic_nif, id_npwp, il_vat, in_gst, is_vat, it_cf, jp_cn, jp_rn, jp_trn, ke_pin, kg_tin, kh_tin, kr_brn, kz_bin, la_tin, li_uid, li_vat, lk_vat, ma_vat, md_vat, me_pib, mk_vat, mr_nif, mx_rfc, my_frp, my_itn, my_sst, ng_tin, no_vat, no_voec, np_pan, nz_gst, om_vat, pe_ruc, ph_tin, pl_nip, py_ruc, ro_tin, rs_pib, ru_inn, ru_kpp, sa_vat, sg_gst, sg_uen, si_tin, sn_ninea, sr_fin, sv_nit, th_vat, tj_tin, tr_tin, tw_vat, tz_vat, ua_vat, ug_tin, unknown, us_ein, uy_ruc, uz_tin, uz_vat, ve_rif, vn_tin, za_vat, zm_tin, zw_tin
`value`	string	Required within parent	Value of the tax ID. Maximum length: 5000
`verification`	JSON	Optional
`verification (anyOf 1)`	JSON	Alternative	Tax ID verification information.
`verification (anyOf 1) (anyOf 1)`	Model	Alternative	Expand Create a tax ID — response body — verification / Tax ID verification information / status: pending, unavailable, unverified, verified
`verification (anyOf 2)`	null	Alternative

Referenced models: Create a customer — response body, Create a tax ID — response body — owner / The account or customer the tax ID belongs to / type: account, application, customer, self, Create a tax ID — response body — verification / Tax ID verification information / status: pending, unavailable, unverified, verified

Create a tax ID — response body — owner / The account or customer the tax ID belongs to / type: account, application, customer, self

Field	Type	Presence	Description and constraints
`$`	object	Root
`account`	JSON	Optional	The account being referenced when `type` is `account`.
`account (anyOf 1)`	string	Alternative	Maximum length: 5000
`account (anyOf 2)`	Model	Alternative	Expand Create an account — response body
`application`	JSON	Optional	The Connect Application being referenced when `type` is `application`.
`application (anyOf 1)`	string	Alternative	Maximum length: 5000
`application (anyOf 2)`	Model	Alternative	Expand PostApplicationFeesIdRefund — response body — application / object: application
`customer`	JSON	Optional	The customer being referenced when `type` is `customer`.
`customer (anyOf 1)`	string	Alternative	Maximum length: 5000
`customer (anyOf 2)`	Model	Alternative	Expand Create a customer — response body
`customer_account`	JSON	Optional
`customer_account (anyOf 1)`	string	Alternative	The Account representing the customer being referenced when `type` is `customer`. Maximum length: 5000
`customer_account (anyOf 2)`	null	Alternative
`type`	string	Required within parent	Type of owner referenced. Known values: account, application, customer, self

Referenced models: Create an account — response body, PostApplicationFeesIdRefund — response body — application / object: application, Create a customer — response body

Create a tax ID — response body — verification / Tax ID verification information / status: pending, unavailable, unverified, verified

Field	Type	Presence	Description and constraints
`$`	object	Root
`status`	string	Required within parent	Verification status, one of `pending`, `verified`, `unverified`, or `unavailable`. Known values: pending, unavailable, unverified, verified
`verified_address`	JSON	Optional
`verified_address (anyOf 1)`	string	Alternative	Verified address. Maximum length: 5000
`verified_address (anyOf 2)`	null	Alternative
`verified_name`	JSON	Optional
`verified_name (anyOf 1)`	string	Alternative	Verified name. Maximum length: 5000
`verified_name (anyOf 2)`	null	Alternative

Delete a tax ID — response body

Field	Type	Presence	Description and constraints
`$`	object	Root
`deleted`	boolean	Required within parent	Always true for a deleted object Known values: True
`id`	string	Required within parent	Unique identifier for the object. Maximum length: 5000
`object`	string	Required within parent	String representing the object's type. Objects of the same type share the same value. Known values: tax_id

Report an issue with this page