Tax Code

Tax codes classify goods and services for tax purposes.

Was this section helpful?YesNo
Retrieve a tax code
GET/v1/tax_codes/:id
List all tax codes
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.

  • requirementsnullable objectPreview feature

    An object that describes more information about the tax location required for this tax code. Some tax codes require a tax location of type performance to calculate tax correctly.

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
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"
}