Taxes
List all tax rates
API Reference
- Getting started
- Add-ons
- Analytics
- Billable metrics
- Coupons
- Credit notes
- Customer usage
- Customers
- Events
- Fees
- Invoices
- Organizations
- Payments
- Payment receipts
- Payment requests
- Plans
- Resources
- Subscriptions
- Taxes
- Wallets
- Webhook endpoints
- Webhooks
Taxes
List all tax rates
This endpoint retrieves all existing taxes representing a customizable tax rate applicable to either the organization or a specific customer.
GET
/
taxes
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"
curl --location --request GET "$LAGO_URL/api/v1/taxes?per_page=2&page=1" \
--header "Authorization: Bearer $API_KEY"
{
"taxes": [
{
"lago_id": "41190609-391a-4368-9549-d4348a85a8cd",
"name": "TVA",
"code": "french_standard_vat",
"description": "French standard VAT",
"rate": 20,
"applied_to_organization": true,
"created_at": "2023-07-06T14:35:58Z"
},
{
"lago_id": "2e034a10-6652-4daf-a600-b085184f93ad",
"name": "TVA",
"code": "french_reduced_vat",
"description": "French reduce VAT",
"rate": 5,
"applied_to_organization": false,
"created_at": "2023-07-06T14:45:23Z"
}
],
"meta": {
"current_page": 1,
"next_page": null,
"prev_page": null,
"total_pages": 1,
"total_count": 2
}
}
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"
curl --location --request GET "$LAGO_URL/api/v1/taxes?per_page=2&page=1" \
--header "Authorization: Bearer $API_KEY"
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Page number.
Example:
1
Number of records per page.
Example:
20
Response
200
application/json
Taxes
Unique identifier of the tax, created by Lago.
Example:
"1a901a90-1a90-1a90-1a90-1a901a901a90"
Name of the tax.
Example:
"TVA"
Unique code used to identify the tax associated with the API request.
Example:
"french_standard_vat"
The percentage rate of the tax
Example:
20
Set to true
if the tax is used as one of the organization's default
Example:
true
Creation date of the tax.
Example:
"2023-07-06T14:35:58Z"
Internal description of the taxe
Example:
"French standard VAT"
Was this page helpful?
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"
curl --location --request GET "$LAGO_URL/api/v1/taxes?per_page=2&page=1" \
--header "Authorization: Bearer $API_KEY"
{
"taxes": [
{
"lago_id": "41190609-391a-4368-9549-d4348a85a8cd",
"name": "TVA",
"code": "french_standard_vat",
"description": "French standard VAT",
"rate": 20,
"applied_to_organization": true,
"created_at": "2023-07-06T14:35:58Z"
},
{
"lago_id": "2e034a10-6652-4daf-a600-b085184f93ad",
"name": "TVA",
"code": "french_reduced_vat",
"description": "French reduce VAT",
"rate": 5,
"applied_to_organization": false,
"created_at": "2023-07-06T14:45:23Z"
}
],
"meta": {
"current_page": 1,
"next_page": null,
"prev_page": null,
"total_pages": 1,
"total_count": 2
}
}