Manage tax rates

Tax rates allow you to define VAT or other local tax percentages. These tax rates can be assigned to financial records such as expenses or bills to simplify your bookkeeping processes.

To manage tax rates via API, you must use an access token with the following scopes:

Create a tax rate​

To add a new tax rate, you must provide the following details:

• Name: A unique name for the tax rate that helps to understand its application.
• Percentage: The percentage for the tax rate, provided as number (from 0 to 100). For example, 23 or 23.00 for 23 %.

For more details and sample requests and responses:

See the API reference: Create a tax rate

Retrieve tax rates​

You can use the API to retrieve tax rates available for your business.

When you retrieve the tax rates, for each tax rate, you get its details, such as the tax rate ID, name, and percentage, as well as when it was created and when it was last updated.

You can:

• Retrieve all the tax rates available in your settings
• Retrieve a specific tax rate

Retrieve a list of tax rates​

When you list all the tax rates available for your business, the results are paginated and sorted by the created_at date in reverse chronological order. To get the next page of results, use the next_page_token value.

For more details and sample requests and responses:

See the API reference: Retrieve a list of tax rates

Retrieve a specific tax rate​

You can also retrieve a specific tax rate by its ID to look up its name, percentage, and dates of creation and last update.

For more details and sample requests and responses:

See the API reference: Retrieve a tax rate

Update a tax rate​

You can use the PATCH request to update the name for a specific tax rate. This can be useful, for example, when there's a typing error in the name, or when the name of the tax itself has changed.

On successful update, you get a 204 response with no additional content.

For more details and sample requests and responses:

See the API reference: Update a tax rate

Delete a tax rate​

To delete a tax rate, simply make a DELETE call providing the ID of this tax rate.

On successful deletion, you get a 204 response with no additional content.

For more details and sample requests and responses:

See the API reference: Delete a tax rate

Pagination​

• Page size: The API returns a maximum of 500 results per request (default: 100). You can increase or decrease the page size, i.e. the maximum number of results returned per page, by explicitly setting the limit parameter.
• Sorting: Results are sorted by the created_at date in reverse chronological order.
• Next Page: If the results exceed the page size, the response includes next_page_token. To fetch the next page of results, make a new request providing this value of next_page_token in the page_token query parameter.

Externally managed settings​

If an accounting software integration is connected, tax rates are typically managed within that external platform. In this state, the tax rates are read-only via the API, and manual modification attempts will return an error.

To find out if your tax rates are managed externally, check the Revolut Business settings.

1. Go to Settings → Accounting → Tax rates.
2. Look for a + New button above the tax rates.

• If you see the button, this means that your tax rates can be modified via the API.
• If you don't see the button, your tax rates are managed externally by the connected integration and cannot be modified (created/updated/deleted) via the API. The name of the connected integration appears near the top, together with information when it was last synced.

Editable	Read-only

See also​

• Accounting settings - overview
• Manage accounting categories
• Manage labels and label groups
• Revolut Help Centre:
  • Expenses
  • Bills