The Tax ID object ​
Attributes ​
id(string) Unique identifier for the object.object(string) String representing the object’s type. Objects of the same type share the same value.country(string, nullable) Two-letter ISO code representing the country of the tax ID.created(timestamp) Time at which the object was created. Measured in seconds since the Unix epoch.customer(string, nullable, expandable (can be expanded into an object with theexpandrequest parameter)) ID of the customer.customer_account(string, nullable) ID of the Account representing the customer.livemode(boolean) If the object exists in live mode, the value istrue. If the object exists in test mode, the value isfalse.owner(object, nullable) The account or customer the tax ID belongs to.owner.account(string, nullable, expandable (can be expanded into an object with theexpandrequest parameter)) The account being referenced whentypeisaccount.owner.application(string, nullable, expandable (can be expanded into an object with theexpandrequest parameter)) The Connect Application being referenced whentypeisapplication.owner.customer(string, nullable, expandable (can be expanded into an object with theexpandrequest parameter)) The customer being referenced whentypeiscustomer.owner.customer_account(string, nullable) The Account representing the customer being referenced whentypeiscustomer.owner.type(enum) Type of owner referenced. Possible enum values:accountIndicates an account is being referenced.applicationIndicates an application is being referenced.customerIndicates a customer is being referenced.selfIndicates that the account being referenced is the account making the API request.
type(enum) Type of the tax ID, one ofad_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,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, orzw_tin. Note that some legacy tax IDs have typeunknownPossible enum values:ad_nrtae_trnal_tinam_tinao_tinar_cuitau_abnau_arnaw_tinaz_tinba_tinbb_tinbd_binbf_ifubg_uicbh_vatbj_ifubo_tinbr_cnpjbr_cpfbs_tinby_tinca_bnca_gst_hstca_pst_bcca_pst_mbca_pst_skca_qstcd_nifch_uidch_vatcl_tincm_niucn_tinco_nitcr_tincv_nifde_stndo_rcnec_ruceg_tines_cifet_tineu_oss_vateu_vatfo_vatgb_vatge_vatgi_tingn_nifhk_brhr_oibhu_tinid_npwpil_vatin_gstis_vatit_cfjp_cnjp_rnjp_trnke_pinkg_tinkh_tinkr_brnkz_binla_tinli_uidli_vatlk_vatma_vatmd_vatme_pibmk_vatmr_nifmx_rfcmy_frpmy_itnmy_sstng_tinno_vatno_voecnp_pannz_gstom_vatpe_rucph_tinpl_nippy_rucro_tinrs_pibru_innru_kppsa_vatsg_gstsg_uensi_tinsn_nineasr_finsv_nitth_vattj_tintr_tintw_vattz_vatua_vatug_tinunknownus_einuy_rucuz_tinuz_vatve_rifvn_tinza_vatzm_tinzw_tin
value(string) Value of the tax ID.verification(object, nullable) Tax ID verification information.verification.status(enum) Verification status, one ofpending,verified,unverified, orunavailable. Possible enum values:pendingunavailableunverifiedverified
verification.verified_address(string, nullable) Verified address.verification.verified_name(string, nullable) Verified name.
The Tax ID object ​
json
{
"id": "txi_1NuMB12eZvKYlo2CMecoWkZd",
"object": "tax_id",
"country": "DE",
"created": 123456789,
"customer": null,
"livemode": false,
"type": "eu_vat",
"value": "DE123456789",
"verification": null,
"owner": {
"type": "self",
"customer": null
}
}