Skip to content

Tax IDs ​

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

Endpoints ​

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

Events ​

  • customer.tax_id.created Occurs whenever a tax ID is created for a customer.

  • customer.tax_id.deleted Occurs whenever a tax ID is deleted from a customer.

  • customer.tax_id.updated Occurs whenever a customer’s tax ID is updated.

Stripe API Reference - Self-contained docs reference, refreshed 2026-05-18