GEgetlago
taxes

Create a tax

Changed on

This endpoint creates a new tax representing a customizable tax rate applicable to either a billing entity or a specific customer.

post/taxes

Request

Request body

Example request

{
  "tax": {
    "name": "TVA",
    "code": "french_standard_vat",
    "description": "French standard VAT",
    "applied_to_organization": true
  }
}

Response

Tax created

Example response

{
  "tax": {
    "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"
  }
}

Changes

  • 5d26657495a3Revision changes
    • breaking

      the / request property type changed from string to string number

    • info

      added the optional property / to the response with the status

    • info

      the response property / became required for the status