---
title: "List all taxes"
method: GET
path: "/taxes"
tags: ["Taxes"]
---

# List all taxes

`GET /taxes`

## Request

- Base URL: `https://api-m.sandbox.paypal.com`
- URL: `https://api-m.sandbox.paypal.com/taxes`
- 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/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a paginated list of all taxes

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Successfully retrieved taxes

- TaxesPaginated: Paginated list of tax objects
  - `taxes` TaxResponse[], required
    - `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
  - `meta` PaginationMetadata, required
    - `total_count` integer
    - `total_pages` integer
    - `current_page` integer

## Other responses

- `403`: Authorization failed due to insufficient permissions.
- `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)