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 with optional pagination parameters. On successful request processing, PayPal returns a paginated list of all configured taxes. 
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>'

​
Query parameters

For the exhaustive list of query and response parameters, see API reference.
Parameter nameDescription
page
integer		Page number for pagination. Default is 1.
per_page
integer		Number of items per page. Default is 10, maximum is 100.

​
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.
On successful request processing, the PayPal server returns the updated tax object. 
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"
    }'
For the exhaustive list of request and response parameters, see API reference.

​
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>'