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

## Changes

- **2026-02-28** `7e426dce5dda` — 2 info
  - api tag `Contexts` added
  - api tag `Context Sharing` removed
- **2026-02-19** `c41dcb6ac8f7` — 2 info
  - api tag `Context Sharing` added
  - api tag `Contexts` removed
- **2026-02-14** `5b3db391b9ea` — 3 info
  - api tag `Contexts` added
  - api tag `v2-api` removed
  - api tag `v2-api-contexts` removed

[Change history](https://skmtc.dev/nozomio-labs/apis/nia-ai-api/changes/contexts/get.md)

---

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