# Create a Customer tax ID

Creates a new `tax_id` object for a customer.

## Prerequisites

Before you can run the following code snippet, you need to call these APIs with the provided parameters to set up the prerequisite API object(s).

1. createCustomer
POST /v1/customers {"name":"Jenny Rosen","email":"jennyrosen@example.com"}

## Request

```curl
curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}}/tax_ids \
  -u "<<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-10-28.endive" \
  -d type=eu_vat \
  -d value=DE123456789
```

### Response

```json
{
  "id": "txi_1MoC8zLkdIwHu7ixEhgWcHzJ",
  "object": "tax_id",
  "country": "DE",
  "created": 1679431857,
  "customer": "cus_NZKoSNZZ58qtO0",
  "livemode": false,
  "type": "eu_vat",
  "value": "DE123456789",
  "verification": {
    "status": "pending",
    "verified_address": null,
    "verified_name": null
  }
}
```

## Parameters

- `id` (string, required)
  Unique identifier for the object.

- `type` (enum, required)
  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`
  - `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`
  - `zw_tin`

- `value` (string, required)
  Value of the tax ID.

## Returns

The created `tax_id` object.