Update a tax rate

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
    }
  }'

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

PUT

taxes

{code}

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
    }
  }'

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

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

tax.name

string

Name of the tax.

Example:

"TVA"

tax.code

string

Unique code used to identify the tax associated with the API request.

Example:

"french_standard_vat"

tax.rate

string

The percentage rate of the tax

Example:

"20.0"

tax.description

string | null

Internal description of the taxe

Example:

"French standard VAT"

tax.applied_to_organization

boolean

deprecated

This field is deprecated and will be removed in a future version. When set to true, it applies the tax to the organization's default billing entity. To apply or remove a tax from any billing entity (including the default one), please use the PUT /billing_entities/:code endpoint instead.

Example:

true

Response

Tax updated

tax

object

required

Show child attributes

tax.lago_id

string<uuid>

required

Unique identifier of the tax, created by Lago.

Example:

"1a901a90-1a90-1a90-1a90-1a901a901a90"

tax.name

string

required

Name of the tax.

Example:

"TVA"

tax.code

string

required

Unique code used to identify the tax associated with the API request.

Example:

"french_standard_vat"

tax.rate

number

required

The percentage rate of the tax

Example:

20

tax.applied_to_organization

boolean

required

deprecated

Example:

true

tax.created_at

string<date-time>

required

Creation date of the tax.

Example:

"2023-07-06T14:35:58Z"

tax.description

string | null

Internal description of the tax

Example:

"French standard VAT"

Create a tax rate Delete a tax rate

⌘I

API Reference

Authorizations

Path Parameters

Body

Response