---
title: "Queries clients for the current customer."
method: GET
path: "/clients"
tags: ["Client"]
---

# Queries clients for the current customer.

`GET /clients`

Clients are service credentials that allow automated processes to authenticate against the API.

## Query parameters

- `page` integer
- `page_size` integer
- `sort` string[]
- `client_id` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `display_name` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `created_at` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `logic` 'and' | 'or'

## Response `200`

OK

- QueryClientsEndpointPagedResultOfOutput
  - `total` integer, required
  - `page` integer, required
  - `pageSize` integer, required
  - `items` QueryClientsEndpointOutput[], required
    - `clientId` string, nullable, required — The id of the client.
    - `displayName` string, nullable, required — The optional display name of the client.
    - `organizationId` string, nullable, required — The id of the organization the client is authorized for.
    - `organizationName` string, nullable, required — The name of the organization the client is authorized for.
    - `createdAt` string, date-time, nullable, required — The time at which the client was created.
  - `totalPages` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

## Changes

- **2026-09-04** `9da534659e5f` — 1 info
  - the security scope `api` was added to the endpoint's security scheme `OpenIdConnect`
- **2026-08-31** `f5235270ce3c` — 2 info
  - added the required property `items/items/organizationId` to the response with the `200` status
  - added the required property `items/items/organizationName` to the response with the `200` status

[Change history](https://skmtc.dev/rapidata/apis/rapidata-api/changes/clients/get.md)

---

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