Skip to main content
Limited Release
Tax management helps you track and maintain tax configurations after you create them. You can retrieve all configured taxes and modify tax rates when regulatory requirements change. This ensures accurate tax calculations across your billing operations. It is your responsibility to ensure the accuracy of the tax calculation and to remit such taxes to the appropriate tax authorities.

​
List taxes

Use a valid access token and make a GET call to the /v1/commerce/billing/taxes endpoint. Include the following query parameters:
ParameterAction
page
integer		Set the page number for paginated results. Default is 1.
per_page
integer		Set the number of items to return per page. Default is 10, maximum is 100.
curl -X GET 'https://api-m.sandbox.paypal.com/v1/commerce/billing/taxes?page=1&per_page=10' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer <ACCESS-TOKEN>'
A successful call returns a 200 OK response with a paginated list of all configured taxes.

​
Update tax details

Use a valid access token and make a PUT call to the /v1/commerce/billing/taxes/{tax_code} endpoint with the modified request parameters such as name, rate, and description. Path parameter: tax_code is the code you provided when you created the tax.
You cannot modify the tax code after creation. You can only update the name, rate, and description.
For information on all parameters, see API reference. 
curl -X PUT 'https://api-m.sandbox.paypal.com/v1/commerce/billing/taxes/standard_vat' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer <ACCESS-TOKEN>' \
    -d '{
      "name": "Updated VAT",
      "rate": "21.50",
      "description": "Updated Value Added Tax"
    }'
A successful call returns a 200 OK response with the updated tax information.

​
Delete tax

Use a valid access token and make a DELETE call to the /v1/commerce/billing/taxes/{tax_code} endpoint to permanently delete a tax configuration. Path parameter: tax_code is the code you provided when you created the tax.
Deleting a tax configuration is permanent and affects all billing entities, plans, and subscriptions using this tax. Ensure this action aligns with your compliance requirements.
curl -X DELETE 'https://api-m.sandbox.paypal.com/v1/commerce/billing/taxes/standard_vat' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer <ACCESS-TOKEN>'
A successful call returns a 204 No Content response.