---
title: "List contexts"
method: GET
path: "/contexts"
tags: ["Contexts"]
---

# List contexts

`GET /contexts`

List conversation contexts with pagination. Filter by tags, agent source, or memory type.

## Query parameters

- `limit` integer — Number of contexts to return
- `offset` integer — Number of contexts to skip
- `tags` string, nullable — Comma-separated tags to filter by
- `agent_source` string, nullable — Filter by agent source
- `memory_type` string, nullable — Filter by memory type: scratchpad, episodic, fact, procedural

## Response `200`

Successful Response

- ContextListCompatResponse — Backwards-compatible context list response.
  - `items` object[] — List of contexts
  - `pagination` PaginationInfo, required — Pagination metadata.
    - `total` integer, required — Total number of items
    - `limit` integer, required — Items per page
    - `offset` integer, required — Current offset
    - `has_more` boolean, required — Whether more items exist
  - `contexts` object[] — Legacy contexts list
  - `total` integer, required — Legacy total count

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nozomio-labs/apis/nia-ai-api.md) · [All operations](https://skmtc.net/nozomio-labs/apis/nia-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nozomio-labs/nia-ai-api/versions/dbb602a3ef17/schema)