Core Resources
Payment Methods
Products
Checkout
Payment Links
Billing
Capital
Connect
Reserves
Fraud
Issuing
Terminal
Treasury
Payment Records
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Webhooks

List all tax IDs 

Returns a list of tax IDs.

Parameters

  • ownerobject

    The account or customer the tax ID belongs to. Defaults to owner[type]=self.

More parameters

  • ending_beforestring

  • limitinteger

  • starting_afterstring

Returns

A dictionary with a data property that contains an array of up to limit tax IDs, starting after tax ID starting_after. Each entry in the array is a separate tax_id object. If no more tax IDs are available, the resulting array will be empty.

GET /v1/tax_ids
curl -G https://api.stripe.com/v1/tax_ids \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d limit=3
Response
{
  "object": "list",
  "url": "/v1/tax_ids",
  "has_more": false,
  "data": [
    {
      "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
      }
    }
  ]
}

Delete a Customer tax ID 

Deletes an existing tax_id object.

Parameters

No parameters.

Returns

Returns an object with a deleted parameter on success. If the tax_id object does not exist, this call raises an error.

DELETE /v1/customers/:id/tax_ids/:id
curl -X DELETE https://api.stripe.com/v1/customers/cus_NZKoSNZZ58qtO0/tax_ids/txi_1MoC8zLkdIwHu7ixEhgWcHzJ \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:"
Response
{
  "id": "txi_1MoC8zLkdIwHu7ixEhgWcHzJ",
  "object": "tax_id",
  "deleted": true
}

Delete a tax ID 

Deletes an existing account or customer tax_id object.

Parameters

No parameters.

Returns

Returns an object with a deleted parameter on success. If the tax_id object does not exist, this call raises an error.

DELETE /v1/tax_ids/:id
curl -X DELETE https://api.stripe.com/v1/tax_ids/txi_1NuMB12eZvKYlo2CMecoWkZd \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:"
Response
{
  "id": "txi_1NuMB12eZvKYlo2CMecoWkZd",
  "object": "tax_id",
  "deleted": true
}