---
title: "List establishments"
method: GET
path: "/organization/structure/api/establishments"
tags: ["Establishments"]
---

# List establishments

`GET /organization/structure/api/establishments`

Retrieve a list of establishments.

## Query parameters

- `id` integer[]
- `legalUnitId` integer[]
- `search` string
- `isArchived` 'true' | 'false' | 'true,false'
- `page` integer
- `limit` integer
- `fields.root` 'count'

## Response `200`

OK

- object
  - `items` Establishment[]
    - `id` integer, required
    - `name` string, required
    - `code` string, nullable
    - `legalUnitId` integer, required
    - `legalUnit` LegalUnit
      - `id` integer, required
      - `name` string, required
      - `code` string, nullable
      - `legalIdentificationNumber` string, nullable — Depends on the country: - SIREN in France - NIF code in Spain
      - `activityCode` string, nullable — France only: NAF code. Null otherwise.
      - `countryId` string, required — ISO 3166 alpha-2 code for the country this legal-unit belongs to.
      - `country` object
        - `id` integer
        - `name` string
        - `code` string — ISO 3166 alpha-2 code.
        - `currencyCode` string — ISO 4217 code.
        - `currency` object
          - `code` string — ISO 4217 code.
          - `englishName` string — Human readable name for this currency.
          - `symbol` string — e.g. "€" for euros.
        - `defaultTimeZone` string — Identifier of the timezone this legal-unit resides in.
      - `headquartersId` integer — Identifier of the establishment that belongs to this legal-unit and should be considered headquarters for the whole group.
      - `createdAt` string, date-time — Timestamp of the moment this legal-unit was created.
      - `isArchived` boolean — Is this legal-unit archived and thus should no longer be used?
    - `legalIdentificationNumber` string, nullable — NIF code for Spanish establishment, Siret code for French establishment. Null otherwise.
    - `activityCode` string, nullable — In France, NAF code. Null otherwise.
    - `calendarId` integer — Default holidays calendar for employees in this establishment.
    - `address` object, nullable
      - `street` string
      - `zipCode` string
      - `city` string
    - `timezoneId` string — Identifier of the timezone this establishment belongs to.
    - `usersCount` integer — Total number of employees working in this establishment as of today.
    - `createdAt` string, date-time — Timestamp of the moment this establishment was created.
    - `author` object
      - `id` integer
      - `firstName` string
      - `lastName` string
      - `fullname` string
      - `url` string, uri
    - `isArchived` boolean
  - `prev` string, nullable — Cursor of the previous page (used with the ?page={{cursor}} query parameter).
  - `next` string, nullable — Cursor of the next page (used with the ?page={{cursor}} query parameter).

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/luccasoftware/apis/lucca-expenses.md) · [All operations](https://skmtc.net/luccasoftware/apis/lucca-expenses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/luccasoftware/lucca-expenses/revisions/110f9897756c/schema)