> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getlago.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Organization

> Organization settings and billing entities.

| Command                               | Description                                                                                |
| ------------------------------------- | ------------------------------------------------------------------------------------------ |
| `organizations get`                   | Retrieve the organization.                                                                 |
| `organizations update`                | Update settings: address, default currency, invoice numbering, grace period, payment term. |
| `billing-entities create`             | Create a billing entity.                                                                   |
| `billing-entities get <code>`, `list` | Read billing entities.                                                                     |
| `billing-entities update <code>`      | Update.                                                                                    |

A billing entity is a legal entity that issues invoices: its own name, address, tax ID, document numbering, and currency. Customers attach to one with `--billing-entity-code`.

<RequestExample>
  ```bash organizations theme={"dark"}
  lago organizations get --output json --query 'organization.{name: name, currency: default_currency, tz: timezone}'
  lago organizations update --billing-configuration-invoice-grace-period 3 --net-payment-term 30
  ```

  ```bash billing-entities theme={"dark"}
  lago billing-entities create --code acme_eu --name "Acme EU" --legal-name "Acme Europe BV" \
    --default-currency EUR --country NL --timezone Europe/Amsterdam --document-number-prefix ACME-EU
  lago billing-entities list
  lago billing-entities get acme_eu
  ```
</RequestExample>

<ResponseExample>
  ```json organizations get theme={"dark"}
  {
    "organization": {
      "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "name": "Name1",
      "slug": "NAME1-1234",
      "created_at": "2022-05-02T13:04:09Z",
      "webhook_url": "https://webhook.brex.com",
      "webhook_urls": [
        "https://webhook.brex.com",
        "https://webhook2.brex.com"
      ],
      "country": "US",
      "default_currency": "USD",
      "address_line1": "100 Brex Street",
      "address_line2": null,
      "state": "NYC",
      "zipcode": "10000",
      "email": "brex@brex.com",
      "city": "New York",
      "legal_name": null,
      "legal_number": null,
      "document_numbering": "per_customer",
      "document_number_prefix": "ORG-1234",
      "net_payment_term": 30,
      "tax_identification_number": "US123456789",
      "timezone": "America/Los_Angeles",
      "email_settings": [
        "invoice.finalized",
        "credit_note.created"
      ],
      "billing_configuration": {
        "invoice_footer": "This is my customer footer",
        "invoice_grace_period": 3,
        "document_locale": "en"
      },
      "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"
        }
      ],
      "finalize_zero_amount_invoice": false,
      "events_store": "clickhouse"
    }
  }
  ```

  ```text billing-entities create theme={"dark"}
  LAGO_ID  1a901a90-1a90-1a90-1a90-1a901a901a90
  CODE     acme_eu
  NAME     Acme EU
  ```
</ResponseExample>