Zuora Tax Rate Period settings

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:


Key	Value
Curl	POST https://rest.apisandbox.zuora.com/settings/tax-rate-periods/{tax id}
Authorization	Auth Type - Bearer Token <oauth_token>
Headers	Authorization - Bearer <oauth_token> Content-Type - application/json
Body	--data { "endDate": "string \| null", "id": "string", "taxCodeId": "string", "startDate": "string" } Example: `{ "endDate": "2024-12-31", "id": "8ad09a3f7c7a82be017c7abf8e0a0001", "taxCodeId": "47d2609fda26e8f15d7954299457f92e", "startDate": "2024-01-01" }`

Response body:

{
   "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:


Key	Value
Curl	GET https://rest.apisandbox.zuora.com/settings/tax-rate-periods
Authorization	Auth Type - Bearer Token <oauth_token>
Headers	Authorization - Bearer <oauth_token> Content-Type - application/j

Response body:

{
   "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:


Key	Value
Curl	PUT https://rest.apisandbox.zuora.com/settings/tax-rate-periods/{id}
Authorization	Auth Type - Bearer Token <oauth_token>
Headers	Authorization - Bearer <oauth_token> Content-Type - application/j
Body	{ "startDate": "string", "endDate": "srting" }

Response body:

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

Request body:


Key	Value
Curl	DELETE https://rest.apisandbox.zuora.com/settings/tax-rate-periods/{id}
Authorization	Auth Type - Bearer Token <oauth_token>
Headers	Authorization - Bearer <oauth_token> Content-Type - application/j

Response body:

{
   "success": true
}

Welcome to Zuora Product Documentation

Explore our rich library of product information

Zuora Tax Rate Period settings

Create Tax Rate Periods

Get Tax Rate Periods

Update Tax Rate Periods

Delete Tax Rate Periods

zuora-footer