> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Zuora Tax Rate Period settings

> Learn how to manage Zuora tax rate periods through the Settings API.

Learn how to manage Zuora tax rate periods through the Settings API.

## Create Tax Rate Periods

To create a new Tax Rate Period, see the following request and a sample of 200 response:

HTTP request:

`POST https://rest.apisandbox.zuora.com/settings/tax-rate-periods/{tax id}`

Request body:

<table>
  <tr>
    <th>
      Key
    </th>

    <th>
      Value
    </th>
  </tr>

  <tr>
    <td>
      Curl
    </td>

    <td>
      POST [https://rest.apisandbox.zuora.com/settings/tax-rate-periods/\\\{tax](https://rest.apisandbox.zuora.com/settings/tax-rate-periods/\\\{tax) id}
    </td>
  </tr>

  <tr>
    <td>
      Authorization
    </td>

    <td>
      Auth Type - Bearer Token \<oauth_token>
    </td>
  </tr>

  <tr>
    <td>
      Headers
    </td>

    <td>
      * Authorization - Bearer \<oauth_token>
      * Content-Type - application/json
    </td>
  </tr>

  <tr>
    <td>
      Body
    </td>

    <td>
      \--data \{

      "endDate": "string | null",

      "id": "string",

      "taxCodeId": "string",

      "startDate": "string"

      }

      Example:

      ```json
      {   "endDate": "2024-12-31",   
          "id": "8ad09a3f7c7a82be017c7abf8e0a0001",
          "taxCodeId": "47d2609fda26e8f15d7954299457f92e",
          "startDate": "2024-01-01" 
       }
      ```
    </td>
  </tr>
</table>

Response body:

```json
{
   "id": "8ad0845b917ed52101918d374d8c7afb",
   "startDate": "2024-01-01",
   "endDate": "2024-12-31",
   "taxCodeId": "47d2609fea983539f5ccb72c1c5a7540",
   "success": true
}
```

## Get Tax Rate Periods

See the following request and a sample of 200 response to get the tax rate periods.

HTTP request:

`GET https://rest.apisandbox.zuora.com/settings/tax-rate-periods`

Request body:

<table>
  <tr>
    <th>
      Key
    </th>

    <th>
      Value
    </th>
  </tr>

  <tr>
    <td>
      Curl
    </td>

    <td>
      GET [https://rest.apisandbox.zuora.com/settings/tax-rate-periods](https://rest.apisandbox.zuora.com/settings/tax-rate-periods)
    </td>
  </tr>

  <tr>
    <td>
      Authorization
    </td>

    <td>
      Auth Type - Bearer Token \<oauth_token>
    </td>
  </tr>

  <tr>
    <td>
      Headers
    </td>

    <td>
      * Authorization - Bearer \<oauth_token>
      * Content-Type - application/j
    </td>
  </tr>
</table>

Response body:

```json
{
   "taxRatePeriods": [
       {
           "id": "47d2609f879ed615ad13264c0f0168ef",
           "startDate": "2013-01-01",
           "endDate": null,
           "taxCodeId": "47d2609fea983539f5ccb72c1c5a7540"
       },
       {
           "id": "8ad081dd90a5e74f0190ba7523d106b4",
           "startDate": "2024-07-16",
           "endDate": null,
           "taxCodeId": "8ad09c9f8cf2eb2b018cf80cf14e1b13"
       },
       {
           "id": "47d2609fcfa0611147fc0ef6a3eec6ea",
           "startDate": "2012-01-01",
           "endDate": null,
           "taxCodeId": "47d2609f678df74e6ee2c68fb3572aa1"
       }
   ],
   "success": true
}
```

## Update Tax Rate Periods

To update the Tax rate period, see the following request and a sample of 200 response:

HTTP request:

`PUT https://rest.apisandbox.zuora.com/settings/tax-rate-periods/{id}`

Request body:

<table>
  <tr>
    <th>
      Key
    </th>

    <th>
      Value
    </th>
  </tr>

  <tr>
    <td>
      Curl
    </td>

    <td>
      PUT [https://rest.apisandbox.zuora.com/settings/tax-rate-periods/\\\{id\\}](https://rest.apisandbox.zuora.com/settings/tax-rate-periods/\\\{id\\})
    </td>
  </tr>

  <tr>
    <td>
      Authorization
    </td>

    <td>
      Auth Type - Bearer Token \<oauth_token>
    </td>
  </tr>

  <tr>
    <td>
      Headers
    </td>

    <td>
      * Authorization - Bearer \<oauth_token>
      * Content-Type - application/j
    </td>
  </tr>

  <tr>
    <td>
      Body
    </td>

    <td>
      \{

      "startDate": "string",

      "endDate": "srting"

      }
    </td>
  </tr>
</table>

Response body:

```json
{
   "id": "47d2609f879ed615ad13264c0f0168ef",
   "startDate": "2025-01-01",
   "endDate": "2025-12-31",
   "taxCodeId": "47d2609fea983539f5ccb72c1c5a7540",
   "success": true
}
```

## Delete Tax Rate Periods

To delete a tax rate period, see the following request and a sample of 200 response:

HTTP request:

DELETE [https://rest.apisandbox.zuora.com/settings/tax-rate-periods/\\\{id\\}](https://rest.apisandbox.zuora.com/settings/tax-rate-periods/\\\{id\\})

Request body:

<table>
  <tr>
    <th>
      Key
    </th>

    <th>
      Value
    </th>
  </tr>

  <tr>
    <td>
      Curl
    </td>

    <td>
      DELETE [https://rest.apisandbox.zuora.com/settings/tax-rate-periods/\\\{id\\}](https://rest.apisandbox.zuora.com/settings/tax-rate-periods/\\\{id\\})
    </td>
  </tr>

  <tr>
    <td>
      Authorization
    </td>

    <td>
      Auth Type - Bearer Token \<oauth_token>
    </td>
  </tr>

  <tr>
    <td>
      Headers
    </td>

    <td>
      * Authorization - Bearer \<oauth_token>
      * Content-Type - application/j
    </td>
  </tr>
</table>

Response body:

```json
{
   "success": true
}
```