---
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`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/memory/namespaces/{namespace}/profiles`
- Auth: HTTP bearer

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

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

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

---

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