- Documentation
- API References
- Integrations
- Templates
- Blog
- FAQ
- GitHub
- Getting started
Add-ons
Analytics
Billable metrics
Coupons
Credit notes
Customer usage
Customers
Events
Fees
Invoices
Organizations
Plans
Resources
Subscriptions
Taxes
Wallets
Webhook endpoints
Webhooks
API Reference
List all tax rates
This endpoint retrieves all existing taxes representing a customizable tax rate applicable to either the organization or a specific customer.
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Page number.
Number of records per page.
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,
"customers_count": 0,
"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,
"customers_count": 0,
"created_at": "2023-07-06T14:45:23Z"
}
],
"meta": {
"current_page": 1,
"next_page": null,
"prev_page": null,
"total_pages": 1,
"total_count": 2
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Page number.
Number of records per page.
Response
Unique identifier of the tax, created by Lago.
Name of the tax.
Unique code used to identify the tax associated with the API request.
Internal description of the taxe
The percentage rate of the tax
Set to true
if the tax is used as one of the organization's default
Number of add-ons this tax is applied to.
Number of charges this tax is applied to.
Number of customers this tax is applied to (directly or via the organization's default).
Number of plans this tax is applied to.
Creation date of the tax.
Current page.
Next page.
Previous page.
Total number of pages.
Total number of records.
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,
"customers_count": 0,
"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,
"customers_count": 0,
"created_at": "2023-07-06T14:45:23Z"
}
],
"meta": {
"current_page": 1,
"next_page": null,
"prev_page": null,
"total_pages": 1,
"total_count": 2
}
}