---
title: "Archive a tax region"
description: "Soft — enabled=false."
canonical_url: "https://twominutebilling.com/help/developers/api-reference/tax/archive-a-tax-region"
---
# Archive a tax region

> Soft — enabled=false.

<api-operation method="DELETE" path="/v1/businesses/{biz}/tax_regions/{txg}">
<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>
  
  <tr>
    <td>
      <code>
        txg
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      <strong>
        yes
      </strong>
    </td>
    
    <td>
      Tax region id (txg_…)
    </td>
  </tr>
</tbody>
</table>

## Headers

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

<tbody>
  <tr>
    <td>
      <code>
        Idempotency-Key
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      no
    </td>
    
    <td>
      Safely retry writes — repeats return the original response. If a write FAILED after it had already taken effect, that failure is what repeats: the key is spent, and a new attempt needs a new key.
    </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.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        id
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The tax region's id (txg_…).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        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>
        country
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The region's country (ISO-3166 alpha-2 code).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        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>
        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>
        home_state_code
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The seller's home state code.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        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>
        registration_number
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      The seller's tax registration number.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        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>
        reverse_charge_enabled
      </code>
    </td>
    
    <td>
      <code>
        boolean
      </code>
    </td>
    
    <td>
      Whether the reverse charge applies in this region.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        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>
        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>
        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>
        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>
        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>
        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>
        export_igst_enabled
      </code>
    </td>
    
    <td>
      <code>
        boolean
      </code>
    </td>
    
    <td>
      Whether export sales are charged IGST.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        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>
        export_zero_rated_enabled
      </code>
    </td>
    
    <td>
      <code>
        boolean
      </code>
    </td>
    
    <td>
      Whether export sales are zero-rated.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        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>
        enabled
      </code>
    </td>
    
    <td>
      <code>
        boolean
      </code>
    </td>
    
    <td>
      True if the region is enabled.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        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>
        components
      </code>
    </td>
    
    <td>
      <code>
        array of object
      </code>
    </td>
    
    <td>
      The tax region's components.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        state_registrations
      </code>
    </td>
    
    <td>
      <code>
        array of object
      </code>
    </td>
    
    <td>
      The tax region's state registrations.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        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>
      Success
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        404
      </code>
    </td>
    
    <td>
      No such tax region
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        409
      </code>
    </td>
    
    <td>
      Idempotency-Key conflict — the key is already in flight, or was reused with a different request payload.
    </td>
  </tr>
</tbody>
</table>
</template>

<template v-slot:request="">

```bash [Request]
curl -X DELETE "$TMBILLING_URL/v1/businesses/biz_XXXXXXXXXXXX01/tax_regions/txg_XXXXXXXXXXXX01" \
  -H "Authorization: Bearer $TMBILLING_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

</template>

<template v-slot:response="">
<code-group>

```json [200 OK]
{
  "object": "tax_region",
  "id": "txg_XXXXXXXXXXXX01",
  "tax_profile_id": "txp_XXXXXXXXXXXX01",
  "country": "US",
  "regime": "gst",
  "price_type": "exclusive",
  "home_state_code": "welcome-10",
  "registration_label": "gstin",
  "registration_number": "EU123456789",
  "collect_registration_number": false,
  "reverse_charge_enabled": false,
  "show_reverse_charge_note": false,
  "reverse_charge_note": null,
  "sez_igst_enabled": false,
  "sez_igst_note": null,
  "sez_zero_rated_enabled": false,
  "sez_zero_rated_note": null,
  "export_igst_enabled": false,
  "export_igst_note": null,
  "export_zero_rated_enabled": false,
  "export_zero_rated_note": null,
  "enabled": false,
  "allowed_tax_treatments": [
    "default"
  ],
  "components": [
    {
      "object": "tax_rate_component",
      "id": "txc_XXXXXXXXXXXX01",
      "name": "CGST",
      "rate_bps": 1000,
      "applies_to": "intra"
    }
  ],
  "state_registrations": [
    {
      "object": "tax_state_registration",
      "id": "txs_XXXXXXXXXXXX01",
      "state_code": "TN"
    }
  ],
  "created_at": "2026-03-14T09:30:00Z"
}
```

```json [404 Not Found]
{
  "error": {
    "type": "invalid_request_error",
    "message": "No such tax region"
  }
}
```

```json [409 Conflict]
{
  "error": {
    "type": "idempotency_error",
    "message": "Idempotency-Key conflict — the key is already in flight, or was reused with a different request payload."
  }
}
```

</code-group>
</template>
</api-operation>


## Sitemap

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