PUT
/
billing_entities
/
{code}
Update a billing entity
curl --request PUT \
  --url https://api.getlago.com/api/v1/billing_entities/{code} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Acme Corp",
  "default_currency": "USD",
  "document_numbering": "per_customer",
  "document_number_prefix": "ABC-123",
  "finalize_zero_amount_invoice": true,
  "billing_configuration": {
    "invoice_footer": "Thank you for your business",
    "document_locale": "en",
    "invoice_grace_period": 0
  },
  "net_payment_term": 0,
  "address_line1": "5230 Penfield Ave",
  "address_line2": "Suite 100",
  "city": "Woodland Hills",
  "state": "CA",
  "country": "US",
  "zipcode": "91364",
  "email": "billing@acme.com",
  "legal_name": "Acme Corporation",
  "legal_number": "US123456789",
  "tax_identification_number": "EU123456789",
  "timezone": "UTC",
  "tax_codes": [
    "french_standard_vat"
  ],
  "email_settings": [
    "invoice.finalized"
  ],
  "eu_tax_management": false,
  "logo": "data:image/png;base64,...",
  "invoice_custom_section_codes": [
    "custom_section_1",
    "custom_section_2"
  ]
}'
{
  "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
  "code": "acme_corp",
  "name": "Acme Corp",
  "default_currency": "USD",
  "document_locale": "en",
  "document_numbering": "per_customer",
  "document_number_prefix": "ABC-123",
  "finalize_zero_amount_invoice": true,
  "invoice_footer": "Thank you for your business",
  "invoice_grace_period": 0,
  "is_default": false,
  "net_payment_term": 0,
  "address_line1": "5230 Penfield Ave",
  "address_line2": "Suite 100",
  "city": "Woodland Hills",
  "state": "CA",
  "country": "US",
  "zipcode": "91364",
  "email": "billing@acme.com",
  "legal_name": "Acme Corporation",
  "legal_number": "US123456789",
  "tax_identification_number": "EU123456789",
  "timezone": "UTC",
  "email_settings": [
    "invoice.finalized"
  ],
  "eu_tax_management": false,
  "logo_url": "https://getlago.com/logo.png",
  "created_at": "2022-04-29T08:59:51Z",
  "updated_at": "2022-04-29T08:59:51Z",
  "taxes": [
    {
      "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "name": "TVA",
      "code": "french_standard_vat",
      "description": "French standard VAT",
      "rate": 20,
      "applied_to_organization": true,
      "created_at": "2023-07-06T14:35:58Z"
    }
  ],
  "selected_invoice_custom_sections": [
    {
      "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "name": "EU Bank Details",
      "code": "eu_bank_details",
      "description": "This section contains the bank details for EU customers.",
      "details": "Bank Name: Lago Bank, IBAN: FR7630004000031234567890143",
      "display_name": "Bank Details:",
      "applied_to_organization": true,
      "organization_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "created_at": "2023-07-06T14:35:58Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
code
string<uuid>
required

The ID of the billing entity

Body

application/json

The billing entity update payload

Billing entity update input

Response

Billing entity updated

Billing entity object