Retrieve tax rates

Production

https://api.paypaga.com

GET

/v2/taxes

Retrieve the catalogue of tax rates applicable to various countries, products, and payment methods.

Error codes for Retrieve Tax Rates

HTTP status	Error code	Description
400	VALIDATION_ERROR	Request validation failed
401	UNAUTHORIZED	Missing or invalid authorization token
403	FORBIDDEN	You do not have permission to access this resource
500	INTERNAL_ERROR	Unexpected server error

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://api.paypaga.com/oauth2/token

Query Params

Responses

🟢200

application/json

Tax rate catalogue.

Bodyapplication/json

🟠400ValidationError

🟠401Unauthorized

🟠403Forbidden

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.paypaga.com/v2/taxes?country=undefined&product=undefined&payment_method=undefined'

Response Example

200 - Example 1

{
    "items": [
        {
            "country": "BR",
            "currency": "BRL",
            "product": "pay_in",
            "type": "percentage",
            "applies_to": "amount",
            "value": 0.02
        }
    ]
}

Modified at 2026-06-09 15:16:31

Retrieve exchange rates

Create a notification subscription

Retrieve tax rates

Error codes for Retrieve Tax Rates#

Request

Responses

Error codes for Retrieve Tax Rates