---
title: "List profiles"
method: GET
path: "/v1/profiles"
tags: ["Profiles"]
---

# List profiles

`GET /v1/profiles`

Returns profiles sorted default-first, then by creation date. Filter with name (exact match) and paginate with limit/skip; without those params the full list is returned unchanged. Use includeOverLimit=true to include profiles that exceed the plan limit.

## Query parameters

- `includeOverLimit` boolean
- `name` string
- `limit` integer
- `skip` integer

## Response `200`

Profiles

- ProfilesListResponse
  - `profiles` Profile[]
    - `_id` string
    - `userId` string
    - `name` string
    - `description` string
    - `color` string
    - `isDefault` boolean
    - `isOverLimit` boolean — Only present when includeOverLimit=true. Indicates if this profile exceeds the plan limit.
    - `createdAt` string, date-time
  - `total` integer — Total matching profiles across all pages. Present only when limit or skip was passed.
  - `skip` integer — Offset applied. Present only when limit or skip was passed.
  - `limit` integer — Echo of the limit query param. Present only when it was passed.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/f81ca70ea6b9/schema)