Zuora Tax Rate Period Settings
Describes managing tax rate periods, including retrieval, creation, updating, and deletion 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 |
|
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 | GEThttps ://rest.apisandbox.zuora.com/settings/tax-rate-periods |
Authorization | Auth Type - Bearer Token <oauth_token> |
Headers |
|
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 |
|
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 |
|
Response body:
{ "success": true }