---
title: "List Datastores"
method: GET
path: "/datastores"
tags: ["/datastores"]
---

# List Datastores

`GET /datastores`

Retrieve a list of `Datastores`.

Performs `cursor`-based pagination if the number of `Datastores` exceeds the requested `limit`. The returned `cursor` can be passed to the next `GET /datastores` call to retrieve the next set of `Datastores`.

## Query parameters

- `agent_id` string, uuid — ID of the agent used to filter datastores. If provided, only datastores linked to this agent will be returned.
- `limit` integer — Maximum number of datastores to return
- `cursor` string — Cursor from the previous call to list datastores, used to retrieve the next set of results

## Response `200`

Successful Response

- DatastoreOutputList
  - `total_count` integer, required — Total number of available datastores
  - `next_cursor` string — Next cursor to continue pagination. Omitted if there are no more datastores to retrieve.
  - `datastores` DatastoreOutputEntry[], required — List of all datastores
    - `id` string, uuid, required — ID of the datastore
    - `name` string, required — Name of the datastore
    - `created_at` string, date-time, required — Timestamp of when the datastore was created

## Other responses

- `422` — Validation Error

## Changes

- **2025-01-14** `4dd01a1cc34b` — 2 warning, 1 info
  - deleted the `query` request parameter `application_id`
  - deleted the `query` request parameter `search`
  - added the new optional `query` request parameter `agent_id`
- **2025-01-07** `cd093ffe7745` — 1 info
  - added the new optional `query` request parameter `search`
- **2025-01-06** `017875f5f674` — 1 info
  - added the new optional `query` request parameter `application_id`

[Change history](https://skmtc.dev/contextualai/apis/endpoints/changes/datastores/get.md)

---

[API](https://skmtc.dev/contextualai/apis/endpoints.md) · [All operations](https://skmtc.dev/contextualai/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/contextualai/endpoints/revisions/17bdb8a33fb4/schema)