---
title: "List your clients"
method: GET
path: "/v1/clients"
tags: ["Clients"]
---

# List your clients

`GET /v1/clients`

## Request

- Base URL: `https://api.pasito.ai`
- URL: `https://api.pasito.ai/v1/clients`
- Auth: HTTP bearer

## Query parameters

- `limit` integer

## Response `200`

Default Response

- object
  - `clients` Client[], required
    - `id` string, required: Client id (e.g. com_a1b2c3d4e5f6g7).
    - `aliasExternalId` string, nullable, required: Your own id for this client, as Pasito has it recorded — the value an SFTP drop folder segment or a REST `clientId` is matched against when you address a client by your id rather than its `com_` id. `null` when no mapping exists yet, in which case only the `com_` id resolves.
    - `displayName` string, required
    - `name` string, required: URL-safe slug.
    - `type` string, required
    - `status` string, required
    - `domain` string, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `401`: Default Response
- `403`: Default Response
- `429`: Default Response

---

[API](https://skmtc.dev/pasito/apis/pasito-external-api.md) - [All operations](https://skmtc.dev/pasito/apis/pasito-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pasito/apis/pasito-external-api/revisions/d206e98c9d61?raw)