---
title: "List a namespace's profiles"
method: GET
path: "/ai/memory/namespaces/{namespace}/profiles"
tags: ["Profiles"]
---

# List a namespace's profiles

`GET /ai/memory/namespaces/{namespace}/profiles`

Profiles are never created, only written to, so this lists the ones that hold a memory. A profile whose first ingest is still running is not here yet. Ordered by memory count, largest first, so a profile written to while the listing is paged can move between pages and be repeated or missed.

## Path parameters

- `namespace` string, required

## Query parameters

- `page[number]` integer
- `page[size]` integer

## Response `200`

Successful Response

- ProfileListResponse
  - `data` Profile[], required
    - `profile_id` string, required
    - `memory_count` integer, required — Memories stored under this profile, including the consolidated ones that paraphrase others. Listings are ordered by it.
  - `meta` PageMeta, required — Where a listing's page sits in the whole. A page is a snapshot: the counts it reports and the order it is drawn in both move as writes land, so paging through a busy namespace can repeat or miss an entry at a page boundary.
    - `page_number` integer, required — The page returned, counting from 1.
    - `page_size` integer, required — How many results a page holds.
    - `total_pages` integer, required — Pages that can be requested; 0 when nothing matched. Page until `page_number` reaches it rather than until a page comes back short: a page can hold fewer than `page_size` results without being the last. Capped at the deepest page served, so on a very large listing it covers fewer results than `total_results`.
    - `total_results` integer, required — Results the request matched, including any past the deepest page.

## Other responses

- `401` — Unauthorized
- `404` — The namespace does not exist
- `422` — Invalid request
- `502` — Upstream error

## Changes

> 99 revisions in range; 1 not diffed.

- **2026-09-25** `88481995b4ca` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/ai/memory/namespaces/:namespace/profiles/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/227c33b1ac9c?raw)