---
title: "List Clients"
method: GET
path: "/timmi-project/api/v4/clients"
tags: ["Clients"]
---

# List Clients

`GET /timmi-project/api/v4/clients`

List clients from an organization.

## Query parameters

- `organizationId` integer, required
- `page` integer
- `limit` integer
- `fields.root` 'count'
- `search` string[]
- `code` string

## Response `200`

OK

- object
  - `items` Client[]
    - `id` number
    - `name` string, required
    - `code` string, required — **Unique** code for this client. Used for identifying the client in invoices export if externalCode is null.
    - `externalCode` string, nullable — Used for identifying the client in invoices exports. Is not subject to unicity.
    - `ownerId` integer, nullable — Unique identifier of the user managing this client.
    - `owner` object, nullable
      - `id` integer
      - `firstName` string
      - `lastName` string
      - `dtContractEnd` string, uri, nullable
      - `picture` object
        - `href` string, uri
      - `establishmentId` integer
    - `organizationId` integer, required — Unique identifier of the [organization](reference/Timmi-Project.yaml/components/schemas/Organization) this client belongs to.
  - `next` string, uri, nullable
  - `prev` string, uri, nullable
  - `count` integer, nullable

## Other responses

- `400` — Problem
- `401` — Problem
- `404` — Problem
- `500` — Problem

---

[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)