---
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
    - `datastore_type` 'UNSTRUCTURED', required — Type of the datastore
    - `configuration` UnstructuredDatastoreConfigModel — Configuration for unstructured datastores.
      - `parsing` DatastoreParseConfiguration — Configuration for data extraction settings from documents at datastore level. Controls settings for document parsing. Includes those from `/parse` API along with some extra ingestion-only ones.
        - `figure_captioning_prompt` string — Prompt to use for generating image captions. Must be non-empty if `figure_caption_mode` is `custom`. Otherwise, must be null.
        - `figure_caption_mode` 'default' | 'custom' | 'ignore' — Mode for figure captioning. - `default`: Use the default figure prompt, which generates a detailed caption for each figure. - `custom`: Use a custom prompt. - `ignore`: Disable figure captioning.
        - `enable_split_tables` boolean — Whether to enable table splitting, which splits large tables into smaller tables with at most `max_split_table_cells` cells each. In each split table, the table headers are reproduced as the first row(s). This is useful for preserving context when tables are too large to fit into one chunk.
        - `max_split_table_cells` integer — Maximum number of cells for split tables. Ignored if `enable_split_tables` is False.
      - `chunking` ChunkingConfiguration — Configuration for document chunking settings.
        - `chunking_mode` 'hierarchy_depth' | 'hierarchy_heading' | 'static_length' | 'page_level' — Defines available chunking strategies. - `hierarchy_depth`: Creates a new chunk whenever a higher-level section heading is encountered. - `hierarchy_heading`: Creates a new chunk whenever any section heading is encountered. - `static_length`: Creates chunks of a fixed length. - `page_level`: Creates chunks that cannot run over page boundaries.
        - `max_chunk_length_tokens` integer — Target maximum length of text tokens chunks for chunking. Chunk length may exceed this value in some edge cases.
        - `min_chunk_length_tokens` integer — Target minimum length of chunks in tokens. Must be at least 384 tokens less than `max_chunk_length_tokens`. Chunk length may be shorter than this value in some edge cases. Ignored if `chunking_mode` is `page_level`.
        - `enable_hierarchy_based_contextualization` boolean — Whether to enable section-based contextualization for chunking
      - `html_config` HtmlConfiguration — Configuration for HTML document ingestion settings.
        - `max_chunk_length_tokens` integer — Target maximum length of text tokens chunks for chunking. Chunk length may exceed this value in some edge cases.
    - `created_at` string, date-time, required — Timestamp of when the datastore was created, in ISO format

## Other responses

- `422` — Validation Error

## Changes

- **2025-08-26** `db7245c74772` — 2 info
  - added the optional property `datastores/items/configuration` to the response with the `200` status
  - added the required property `datastores/items/datastore_type` to the response with the `200` status
- **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/ca7f807eec8b/schema)