---
title: "List Customers"
method: GET
path: "/v1/customer"
---

# List Customers

`GET /v1/customer`

List all customers

## Query parameters

- `limit` integer — Limit the number of items returned
- `offset` integer — Offset the items returned
- `search_query` string, nullable

## Response `200`

Successful response

- object
  - `items` object[], required
    - `id` string, nullable, required — Customer Id
    - `connection_count` number, required
    - `created_at` string, required — postgres timestamp format, not yet ISO
    - `updated_at` string, required — postgres timestamp format, not yet ISO
  - `total` integer, required — Total number of items in the database for the organization
  - `limit` integer, required — Limit the number of items returned
  - `offset` integer, required — Offset the items returned
  - `has_next_page` boolean — Convenience flag = offset + limit >= total

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/openintegrations/apis/openint-api.md) · [All operations](https://skmtc.net/openintegrations/apis/openint-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openintegrations/openint-api/versions/1b84cd7f5c05/schema)