---
title: "List tax locations"
method: GET
path: "/v1/tax/locations"
---

# List tax locations

`GET /v1/tax/locations`

## Request

- Base URL: `https://api.stripe.com`
- URL: `https://api.stripe.com/v1/tax/locations`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Retrieve a list of all tax locations. Tax locations can represent the venues for services, tickets, or other product types.

The response includes detailed information for each tax location, such as its address, type, and description.

You can paginate through the list by using the `limit` parameter to control the number of results returned in each request.

## Query parameters

- `ending_before` string
- `expand` string[]
- `limit` integer
- `starting_after` string
- `type` 'performance', required

## Response `200`

Successful response.

- object
  - `data` TaxLocation[], required: Details about each object.
    - `address` Address, required
      - `city` string, nullable: City, district, suburb, town, or village.
      - `country` string, nullable: Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
      - `line1` string, nullable: Address line 1, such as the street, PO Box, or company name.
      - `line2` string, nullable: Address line 2, such as the apartment, suite, unit, or building.
      - `postal_code` string, nullable: ZIP or postal code.
      - `state` string, nullable: State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
    - `description` string, nullable: A descriptive text providing additional context about the tax location. This can include information about the venue, types of events held, services available, or any relevant details for better identification (for example, "A spacious auditorium suitable for large concerts and events.").
    - `id` string, required: Unique identifier for the object.
    - `livemode` boolean, required: If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
    - `object` 'tax.location', required: String representing the object's type. Objects of the same type share the same value.
    - `type` 'performance', required: The type of tax location to be defined. Currently the only option is `performance`.
  - `has_more` boolean, required: True if this list has another page of items after this one that can be fetched.
  - `object` 'list', required: String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
  - `url` string, required: The URL where this list can be accessed.

## Other responses

- `default`: Error response.

---

[API](https://skmtc.dev/stainless-api/apis/stripe-api.md) · [All operations](https://skmtc.dev/stainless-api/apis/stripe-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stainless-api/apis/stripe-api/revisions/7cff4cc46d06?raw)