---
title: "List Scopes"
method: GET
path: "/v1/scopes"
tags: ["memory"]
---

# List Scopes

`GET /v1/scopes`

## Request

- Base URL: `https://api.tmcra.com`
- URL: `https://api.tmcra.com/v1/scopes`
- Auth: HTTP bearer

## Query parameters

- `prefix` string, nullable
- `limit` integer

## Headers

- `X-TMCRA-On-Behalf-Of-Subject` string, nullable: Trusted subject attribution for server-side control-plane proxies. Requires a tokens:manage API key.

## Response `200`

Successful Response

- ScopeCatalogView[]
  - `created_at` number, required
  - `ingest_request_count` integer, required
  - `last_ingest_at` number, nullable
  - `last_recall_at` number, nullable
  - `last_seen_at` number, required
  - `message_count` integer, required
  - `recall_request_count` integer, required
  - `scope_name` string, required
  - `session_count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tmcra/apis/tmcra-memory-api.md) · [All operations](https://skmtc.dev/tmcra/apis/tmcra-memory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tmcra/apis/tmcra-memory-api/revisions/597be9dc7a3d?raw)