GET
/v1/customers/{customer}/tax_ids/{id}Retrieve a customer tax ID
Retrieves a specific tax ID associated with a customer. Provide the customer identifier and tax ID identifier to return the tax ID object, and use expand when you need selected nested fields expanded.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
customerstringrequired
The identifier of the customer that owns the tax ID, limited to 5,000 characters.
idstringrequired
The identifier of the tax ID to retrieve.
expandarray<string>optional
Fields to expand in the response; each value is a string of no more than 5,000 characters.
200Returns the tax ID object with its identifier, type, value, country, customer or account owner, creation time, livemode, and verification information.
countrystringoptional
Two-letter ISO code representing the country of the tax ID.
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
customerstringoptional
ID of the customer.
customer_accountstringoptional
ID of the Account representing the customer.
idstringrequired
Unique identifier for the object.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
ownerobjectoptional
The account or customer the tax ID belongs to.
typestringrequired
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`
valuestringrequired
Value of the tax ID.
verificationobjectoptional
Tax ID verification information.
defaultError response.
errorobjectrequired
Error handling
customer must identify the customer that owns the tax ID, and id must identify the requested tax ID. Each expand entry must be a string of no more than 5,000 characters.