Update a tax rate

This endpoint updates an existing tax representing a customizable tax rate applicable to either the organization or a specific customer.

PUT /taxes/{code}

cURL

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request PUT "$LAGO_URL/api/v1/taxes" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
    "tax": {
      "name": "french vat",
      "code": "french_vat_2",
      "rate": 20.00,
      "description": "Standard VAT",
      "applied_to_organization": false
    }
  }'

200

{
  "tax": {
    "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
    "name": "TVA",
    "code": "french_standard_vat",
    "rate": 20,
    "applied_to_organization": true,
    "created_at": "2023-07-06T14:35:58Z",
    "description": "French standard VAT"
  }
}

cURL

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request PUT "$LAGO_URL/api/v1/taxes" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
    "tax": {
      "name": "french vat",
      "code": "french_vat_2",
      "rate": 20.00,
      "description": "Standard VAT",
      "applied_to_organization": false
    }
  }'

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

code · string · required

The code of the tax. It serves as a unique identifier associated with a particular tax. The code is typically used for internal or system-level identification purposes.

Example:

"french_standard_vat"

Body

application/json

Tax update payload

tax · object · required

Show child attributes

Response

200

application/json

Tax updated

tax · object · required

Show child attributes