---
title: "Update a tax"
method: PUT
path: "/taxes/{tax_code}"
tags: ["Taxes"]
---

# Update a tax

`PUT /taxes/{tax_code}`

## Request

- Base URL: `https://api-m.sandbox.paypal.com`
- URL: `https://api-m.sandbox.paypal.com/taxes/{tax_code}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/api/oauth-proxy` scopes: `read`, `write`
- TypeScript: <https://skmtc.dev/paypal/apis/usage-based-billing-api/docs/taxes/:tax_code/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates an existing tax

## Request body

- TaxUpdateRequest: Base schema for tax request/response objects
  - `name` string, required: Name of the tax
  - `rate` string: The percentage rate of the tax applied to transactions. A decimal amount from 0.01 to 100.00 inclusive, always with exactly two decimal places, no leading zeros except 0.xx.
  - `description` string: Detailed description of the tax for internal reference

## Response `200`

Successfully updated tax

- TaxResponse: Base schema for tax request/response objects
  - `name` string, required: Name of the tax
  - `rate` string: The percentage rate of the tax applied to transactions. A decimal amount from 0.01 to 100.00 inclusive, always with exactly two decimal places, no leading zeros except 0.xx.
  - `description` string: Detailed description of the tax for internal reference
  - `code` string: Unique code used to identify the tax. Must contain only alphanumeric characters, underscores, and hyphens.
  - `id` string, uuid: Unique identifier of the tax
  - `created_at` string, date-time: The effective start date of the subscription; can be past, current, or future. Date must be provided in ISO 8601 format

## Other responses

- `400`: Bad Request - Invalid input data
- `403`: Authorization failed due to insufficient permissions.
- `404`: Resource Not Found.
- `422`: Bad Request - Invalid input data
- `500`: Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.dev/paypal/apis/usage-based-billing-api.md) - [All operations](https://skmtc.dev/paypal/apis/usage-based-billing-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paypal/apis/usage-based-billing-api/revisions/22fb46514ac4?raw)