---
title: "GET /v3/customers"
method: GET
path: "/v3/customers"
tags: ["Customer"]
---

# GET /v3/customers

`GET /v3/customers`

## Query parameters

- `filter` object
  - `active` boolean
  - `fulltext` string
- `items_per_page` integer
- `page` integer
- `scope` 'manageAccess' — Possible values: - `manageAccess`: ManageAccess
- `sort` SortIdNameActive[]

## Response `200`

Successful operation

- object
  - `paging` object, required
    - `items_per_page` integer, required
    - `current_page` integer, required
    - `count_pages` integer, required
    - `count_items` integer, required
  - `data` CustomerV3[], required
    - `id` integer, required
    - `name` string, required
    - `number` string, nullable, required — Freely selectable number for the customer
    - `color` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9, required — Possible values: - `1`: BloodOrange - `2`: Sunflower - `3`: LightGreen - `4`: Caribbean - `5`: Sky - `6`: BrandBlue - `7`: BluePurple - `8`: Magenta - `9`: ChewingGum
    - `active` boolean, required
    - `billable_default` boolean, required
    - `note` string, nullable — Only visible for administrators or workers with elevated access `manage_customers_and_projects`
    - `bill_service_id` string, nullable — Only visible for administrators or workers with elevated access `manage_customers_and_projects` and if a billing application with customers support is linked up
    - `test_data` boolean, required
    - `service_assignments` integer[]

## Other responses

- `400` — Bad request

---

[API](https://skmtc.dev/clockodo/apis/clockodo-api-documentation.md) · [All operations](https://skmtc.dev/clockodo/apis/clockodo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockodo/clockodo-api-documentation/revisions/38e281d50d6d/schema)