Core Resources
Payment Methods
Money Management
Products
Product Catalog
Commerce
Agentic Commerce
Checkout
Payment Links
Billing
Capital
Connect
Reserves
Fraud
Issuing
Terminal
Treasury for Platforms
Payment Records
Account Evaluation
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Tax Reporting
Forwarding
Privacy
Webhooks

Tax IDs v1

You can add one or multiple tax IDs to a customer or account. Customer and account tax IDs get displayed on related invoices and credit notes.

Related guides: Customer tax identification numbers, Account tax IDs

Was this section helpful?YesNo
Create a Customer tax ID
POST/v1/customers/:id/tax_ids
Create a tax ID
POST/v1/tax_ids
Retrieve a Customer tax ID
GET/v1/customers/:id/tax_ids/:id
Retrieve a tax ID
GET/v1/tax_ids/:id
List all Customer tax IDs
GET/v1/customers/:id/tax_ids
List all tax IDs
GET/v1/tax_ids
Delete a Customer tax ID
DELETE/v1/customers/:id/tax_ids/:id
Delete a tax ID
DELETE/v1/tax_ids/:id

The Tax ID object v1

Attributes

  • idstring

    Unique identifier for the object.

  • countrynullable string

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

  • customernullable stringExpandable

    ID of the customer.

  • customer_accountnullable string

    ID of the Account representing the customer.

  • typeenum

    Type of the tax ID, one of ad_nrt, ae_trn, al_tin, am_tin, ao_tin, ar_cuit, au_abn, au_acn, au_arn, au_wpn, 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, bw_vat, by_tin, ca_bn, ca_gst_hst, ca_pst_bc, ca_pst_mb, ca_pst_sk, ca_qst, cd_nif, ch_uid, ch_vat, ci_vat, cl_tin, cm_niu, cn_tin, co_nit, cr_tin, cv_nif, cz_dic, de_stn, do_rcn, ec_ruc, eg_tin, es_cif, et_tin, eu_oss_vat, eu_vat, fo_vat, fr_siren, fr_siret, fr_spi, gb_vat, ge_vat, gh_tin, gi_tin, gn_nif, hk_br, hr_oib, hu_tin, ic_nif, id_npwp, il_vat, in_gst, is_kt, 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_cf, md_vat, me_pib, mk_vat, mr_nif, mu_vat, mx_rfc, my_frp, my_itn, my_sst, mz_nuit, ng_tin, no_vat, no_voec, np_pan, nz_bn, nz_gst, om_vat, pe_ruc, ph_tin, pl_nip, pt_nif, py_ruc, ro_tin, rs_pib, ru_inn, ru_kpp, sa_vat, sg_gst, sg_uen, si_tin, sm_coe, sn_ninea, sr_fin, sv_nit, th_vat, tj_tin, tr_tin, tt_bir, tt_vat, 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

    Possible enum values
    ad_nrt
    ae_trn
    al_tin
    am_tin
    ao_tin
    ar_cuit
    au_abn
    au_acn
    au_arn
    au_wpn
    Show 126 more

  • valuestring

    Value of the tax ID.

More attributes

  • objectstring, value is "tax_id"

  • createdtimestamp

  • livemodeboolean

  • ownernullable object

  • verificationnullable object

The Tax ID object
{
  "id": "",
  "object": "tax_id",
  "country": "DE",
  "created": 123456789,
  "customer": null,
  "livemode": false,
  "type": "eu_vat",
  "value": "DE123456789",
  "verification": null,
  "owner": {
    "type": "self",
    "customer": null
  }
}

Create a Customer tax ID v1

POST /v1/customers/:id/tax_ids

Creates a new tax_id object for a customer.

Parameters

  • idstringRequired

    Unique identifier for the object.

  • typeenumRequired

    Type of the tax ID, one of ad_nrt, ae_trn, al_tin, am_tin, ao_tin, ar_cuit, au_abn, au_acn, au_arn, au_wpn, 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, bw_vat, by_tin, ca_bn, ca_gst_hst, ca_pst_bc, ca_pst_mb, ca_pst_sk, ca_qst, cd_nif, ch_uid, ch_vat, ci_vat, cl_tin, cm_niu, cn_tin, co_nit, cr_tin, cv_nif, cz_dic, de_stn, do_rcn, ec_ruc, eg_tin, es_cif, et_tin, eu_oss_vat, eu_vat, fo_vat, fr_siren, fr_siret, fr_spi, gb_vat, ge_vat, gh_tin, gi_tin, gn_nif, hk_br, hr_oib, hu_tin, ic_nif, id_npwp, il_vat, in_gst, is_kt, 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_cf, md_vat, me_pib, mk_vat, mr_nif, mu_vat, mx_rfc, my_frp, my_itn, my_sst, mz_nuit, ng_tin, no_vat, no_voec, np_pan, nz_bn, nz_gst, om_vat, pe_ruc, ph_tin, pl_nip, pt_nif, py_ruc, ro_tin, rs_pib, ru_inn, ru_kpp, sa_vat, sg_gst, sg_uen, si_tin, sm_coe, sn_ninea, sr_fin, sv_nit, th_vat, tj_tin, tr_tin, tt_bir, tt_vat, 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

    Possible enum values
    ad_nrt
    ae_trn
    al_tin
    am_tin
    ao_tin
    ar_cuit
    au_abn
    au_acn
    au_arn
    au_wpn
    Show 125 more

  • valuestringRequired

    Value of the tax ID.

Returns

The created tax_id object.

curl https://api.stripe.com/v1/customers//tax_ids \
  -u "sk_test_...sk_test_...:" \
  -H "Stripe-Version: 2026-10-28.endive" \
  -d type=eu_vat \
  -d value=DE123456789
Response
{
  "id": "",
  "object": "tax_id",
  "country": "DE",
  "created": 1679431857,
  "customer": "",
  "livemode": false,
  "type": "eu_vat",
  "value": "DE123456789",
  "verification": {
    "status": "pending",
    "verified_address": null,
    "verified_name": null
  }
}