---
title: "List legal-units"
method: GET
path: "/organization/structure/api/legal-units"
tags: ["Legal-Units"]
---

# List legal-units

`GET /organization/structure/api/legal-units`

Retrieve a paginated list of legal-units.

## Query parameters

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

## Response `200`

OK

- object
  - `items` 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?
  - `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/versions/110f9897756c/schema)