---
title: "List tax regions with their components and state registrations"
canonical_url: "https://twominutebilling.com/help/developers/api-reference/tax/list-tax-regions-with-their-components-and-state"
---
# List tax regions with their components and state registrations

<api-operation method="GET" path="/v1/businesses/{biz}/tax_regions">
<template v-slot:docs="">

## Path parameters

<table>
<thead>
  <tr>
    <th>
      Parameter
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Required
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        biz
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      <strong>
        yes
      </strong>
    </td>
    
    <td>
      Business id (biz_…)
    </td>
  </tr>
</tbody>
</table>

## Response

<table>
<thead>
  <tr>
    <th>
      Field
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        object
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The object type; always <code>
        list
      </code>
      
      . One of <code>
        list
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data
      </code>
    </td>
    
    <td>
      <code>
        array of object
      </code>
    </td>
    
    <td>
      The items.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.object
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The object type.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.id
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The tax region's id (txg_…).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.tax_profile_id
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The id of the tax profile the region belongs to (txp_…).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.country
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The region's country (ISO-3166 alpha-2 code).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.regime
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The tax regime. One of <code>
        gst
      </code>
      
      , <code>
        vat
      </code>
      
      , <code>
        sales_tax
      </code>
      
      , <code>
        flat
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.price_type
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      Whether prices include tax or tax is added on top. One of <code>
        exclusive
      </code>
      
      , <code>
        inclusive
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.home_state_code
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The seller's home state code.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.registration_label
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The label for the tax registration number, e.g. <code>
        gstin
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.registration_number
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The seller's tax registration number.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.collect_registration_number
      </code>
    </td>
    
    <td>
      <code>
        boolean
      </code>
    </td>
    
    <td>
      Whether to ask the customer for a tax registration number.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.reverse_charge_enabled
      </code>
    </td>
    
    <td>
      <code>
        boolean
      </code>
    </td>
    
    <td>
      Whether the reverse charge applies in this region.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.show_reverse_charge_note
      </code>
    </td>
    
    <td>
      <code>
        boolean
      </code>
    </td>
    
    <td>
      Whether the reverse charge note is printed on invoices.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.reverse_charge_note
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The note printed on invoices for a reverse charge.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.sez_igst_enabled
      </code>
    </td>
    
    <td>
      <code>
        boolean
      </code>
    </td>
    
    <td>
      Whether sales to a special economic zone are charged IGST.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.sez_igst_note
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The note printed on invoices for an IGST sale to a special economic zone.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.sez_zero_rated_enabled
      </code>
    </td>
    
    <td>
      <code>
        boolean
      </code>
    </td>
    
    <td>
      Whether sales to a special economic zone are zero-rated.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.sez_zero_rated_note
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The note printed on invoices for a zero-rated sale to a special economic zone.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.export_igst_enabled
      </code>
    </td>
    
    <td>
      <code>
        boolean
      </code>
    </td>
    
    <td>
      Whether export sales are charged IGST.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.export_igst_note
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The note printed on invoices for an IGST export sale.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.export_zero_rated_enabled
      </code>
    </td>
    
    <td>
      <code>
        boolean
      </code>
    </td>
    
    <td>
      Whether export sales are zero-rated.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.export_zero_rated_note
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The note printed on invoices for a zero-rated export sale.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.enabled
      </code>
    </td>
    
    <td>
      <code>
        boolean
      </code>
    </td>
    
    <td>
      True if the region is enabled.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.allowed_tax_treatments
      </code>
    </td>
    
    <td>
      <code>
        array of string
      </code>
    </td>
    
    <td>
      The treatments a customer in this region may be assigned, derived from the gates above.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.components
      </code>
    </td>
    
    <td>
      <code>
        array of object
      </code>
    </td>
    
    <td>
      The tax region's components.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.state_registrations
      </code>
    </td>
    
    <td>
      <code>
        array of object
      </code>
    </td>
    
    <td>
      The tax region's state registrations.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data.created_at
      </code>
    </td>
    
    <td>
      <code>
        string · ISO-8601
      </code>
    </td>
    
    <td>
      When the region was created (ISO-8601 UTC).
    </td>
  </tr>
</tbody>
</table>

## Status codes

<table>
<thead>
  <tr>
    <th>
      Status
    </th>
    
    <th>
      Meaning
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        200
      </code>
    </td>
    
    <td>
      List of tax regions
    </td>
  </tr>
</tbody>
</table>
</template>

<template v-slot:request="">

```bash [Request]
curl "$TMBILLING_URL/v1/businesses/biz_XXXXXXXXXXXX01/tax_regions" \
  -H "Authorization: Bearer $TMBILLING_API_KEY"
```

</template>

<template v-slot:response="">

```json [200 OK]
{
  "object": "list",
  "data": [
    {
      "object": "tax_region",
      "id": "txg_XXXXXXXXXXXX01",
      "country": "US",
      "regime": "gst",
      "price_type": "exclusive",
      "enabled": false
    }
  ]
}
```

</template>
</api-operation>


## Sitemap

See the full [sitemap](https://twominutebilling.com/sitemap.md) for all pages.