GEgetlago
taxes

List all taxes

Changed on

This endpoint retrieves all existing taxes representing a customizable tax rate applicable to either a billing entity or a specific customer.

get/taxes

Request

Query parameters

pageinteger
Example:1

Page number. Defaults to 1. A value that is not a positive integer, such as 0, returns the first page.

per_pageinteger
Example:20

Number of records per page. Defaults to 100. The maximum is 200, unless another maximum is configured for your organization. A value above the maximum returns a 422 error with value_is_out_of_range on per_page. A value that is not a positive integer, such as 0, returns the default number of records.

Response

Taxes

Example response

{
  "taxes": [
    {
      "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "name": "TVA",
      "code": "french_standard_vat",
      "description": "French standard VAT",
      "rate": 20,
      "applied_to_organization": true,
      "applied_to_billing_entities_codes": [
        "acme_corp",
        "foo_bar"
      ],
      "created_at": "2023-07-06T14:35:58Z"
    }
  ],
  "meta": {
    "current_page": 2,
    "next_page": 3,
    "prev_page": 1,
    "total_pages": 4,
    "total_count": 70
  }
}

Changes

  • 5d26657495a3Revision changes
    • info

      added the optional property // to the response with the status

    • info

      the response property // became required for the status