Tax Code

Tax codes classify goods and services for tax purposes.

Endpoints

GET/v1/tax_codes/:id

GET/v1/tax_codes

The Tax Code object

Attributes

idstring
Unique identifier for the object.

objectstring
String representing the object’s type. Objects of the same type share the same value.

descriptionstring
A detailed description of which types of products the tax code represents.

namestring
A short name for the tax code.

The Tax Code object

{
  "id": "txcd_99999999",
  "object": "tax_code",
  "description": "Any tangible or physical good. For jurisdictions that impose a tax, the standard rate is applied.",
  "name": "General - Tangible Goods"
}

Retrieve a tax code

Retrieves the details of an existing tax code. Supply the unique tax code ID and Stripe will return the corresponding tax code information.

Parameters

No parameters.

Returns

Returns a tax code object if a valid identifier was provided.

GET /v1/tax_codes/:id

Server-side language

curl https://api.stripe.com/v1/tax_codes/txcd_99999999 \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:"

Response

{
  "id": "txcd_99999999",
  "object": "tax_code",
  "description": "Any tangible or physical good. For jurisdictions that impose a tax, the standard rate is applied.",
  "name": "General - Tangible Goods"
}

List all tax codes

A list of all tax codes available to add to Products in order to allow specific tax calculations.

Parameters

No parameters.

More parameters

ending_beforestring

limitinteger

starting_afterstring

Returns

A dictionary with a data property that contains an array of up to limit tax codes, starting after tax code starting_after. Each entry in the array is a separate tax code object. If no more tax codes are available, the resulting array will be empty. This request should never return an error.

GET /v1/tax_codes

Server-side language

curl -G https://api.stripe.com/v1/tax_codes \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d limit=3

Response

{
  "object": "list",
  "url": "/v1/tax_codes",
  "has_more": false,
  "data": [
    {
      "id": "txcd_99999999",
      "object": "tax_code",
      "description": "Any tangible or physical good. For jurisdictions that impose a tax, the standard rate is applied.",
      "name": "General - Tangible Goods"
    }
  ]
}