Skip to main content

Zuora Tax Rate Period Settings

Zuora

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
  • 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 GEThttps://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
}