Skip to main content
GET
/
taxes
/
{tax_code}
Retrieve a Tax
curl --request GET \
  --url https://api-m.sandbox.paypal.com/v1/commerce/billing/taxes/{tax_code} \
  --header 'Authorization: Bearer <token>'
{
  "id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
  "name": "Standard VAT",
  "code": "standard_vat",
  "description": "Standard Value Added Tax",
  "rate": "20.00",
  "created_at": "2023-07-06T14:35:58Z"
}

Authorizations

​
Authorization
string
header
required

Use the /v1/oauth2/token endpoint to obtain an access token and pass it as a Bearer token in the Authorization header.

Path Parameters

​
tax_code
string
required

Unique identifier code for the tax

Response

Successfully retrieved tax

Represents a customizable tax rate that can be applied to invoices and fees

​
name
string
required

Name of the tax

Example:

"TVA"

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

Pattern: ^(?!0+(?:\.0+)?$)(?:0?\.\d{1,2}|[1-9]\d?(?:\.\d{1,2})?|100(?:\.0{1,2})?)$
Example:

"20.00"

​
description
string

Detailed description of the tax for internal reference

Example:

"French standard VAT"

​
code
string

Unique code used to identify the tax. Must contain only alphanumeric characters, underscores, and hyphens.

Pattern: ^[a-zA-Z0-9_-]*$
Example:

"standard_vat"

​
id
string<uuid>

Unique identifier of the tax

Example:

"1a901a90-1a90-1a90-1a90-1a901a901a90"

​
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

Example:

"2025-06-01T00:00:00Z"