---
title: "Changes to List Documents"
method: GET
path: "/datastores/{datastore_id}/documents"
---

# Changes to List Documents

`GET /datastores/{datastore_id}/documents`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 22 revisions.

- **2026-10-16** `4abdda722de9`: 1 breaking, 1 info
- **2025-10-28** `c8152db45500`: 1 breaking
- **2025-08-26** `db7245c74772`: 5 breaking, 4 info
- **2025-05-08** `17bdb8a33fb4`: 7 info
- **2025-02-26** `5298551c424b`: 6 warning, 3 info
- **2025-01-14** `a02ba25a1da1`: 1 warning, 1 info
- **2025-01-14** `34bdb8a45e5c`: 1 warning, 1 info

## Changes

- **2026-10-16** `4abdda722de9`: 1 breaking, 1 info
  - the `documents/items/ingestion_config` response's property type changed from `object` to no type for status `200`
  - added the new optional `query` request parameter `document_name_search`
- **2025-10-28** `c8152db45500`: 1 breaking
  - response property `documents/items/custom_metadata/additionalProperties/` list-of-types was widened by adding types `array` to media type `application/json` of response `200`
- **2025-08-26** `db7245c74772`: 5 breaking, 4 info
  - removed the enum value `failed_to_generate_data` from the property `items/` of the `query` request parameter `ingestion_job_status`
  - removed the enum value `failed_to_provision` from the property `items/` of the `query` request parameter `ingestion_job_status`
  - removed the enum value `generating_data` from the property `items/` of the `query` request parameter `ingestion_job_status`
  - removed the enum value `provisioning` from the property `items/` of the `query` request parameter `ingestion_job_status`
  - removed the enum value `training_in_progress` from the property `items/` of the `query` request parameter `ingestion_job_status`
  - added the new optional `query` request parameter `document_name_prefix`
  - added the optional property `documents/items/custom_metadata_config` to the response with the `200` status
  - added the optional property `documents/items/has_access` to the response with the `200` status
  - added the optional property `documents/items/ingestion_config` to the response with the `200` status
- **2025-05-08** `17bdb8a33fb4`: 7 info
  - api tag `/datastores/{id}/documents` added
  - api tag `/datastores` removed
  - added the enum value `failed_to_generate_data` to the property `items/` of the `query` request parameter `ingestion_job_status`
  - added the enum value `failed_to_provision` to the property `items/` of the `query` request parameter `ingestion_job_status`
  - added the enum value `generating_data` to the property `items/` of the `query` request parameter `ingestion_job_status`
  - added the enum value `provisioning` to the property `items/` of the `query` request parameter `ingestion_job_status`
  - added the enum value `training_in_progress` to the property `items/` of the `query` request parameter `ingestion_job_status`
- **2025-02-26** `5298551c424b`: 6 warning, 3 info
  - added the new `cancelled` enum value to the `documents/items/status` response property for the response status `200`
  - added the new `completed` enum value to the `documents/items/status` response property for the response status `200`
  - added the new `failed` enum value to the `documents/items/status` response property for the response status `200`
  - added the new `pending` enum value to the `documents/items/status` response property for the response status `200`
  - added the new `processing` enum value to the `documents/items/status` response property for the response status `200`
  - added the new `retrying` enum value to the `documents/items/status` response property for the response status `200`
  - added the optional property `documents/items/custom_metadata` to the response with the `200` status
  - added the optional property `documents/items/updated_at` to the response with the `200` status
  - added the required property `documents/items/created_at` to the response with the `200` status
- **2025-01-14** `a02ba25a1da1`: 1 warning, 1 info
  - deleted the `query` request parameter `ingestion_job_status[]`
  - added the new optional `query` request parameter `ingestion_job_status`
- **2025-01-14** `34bdb8a45e5c`: 1 warning, 1 info
  - deleted the `query` request parameter `ingestion_job_status`
  - added the new optional `query` request parameter `ingestion_job_status[]`

---

[Operation](https://skmtc.dev/contextualai/apis/endpoints/docs/datastores/:datastore_id/documents/get.md) - [API](https://skmtc.dev/contextualai/apis/endpoints.md) - [Page](https://skmtc.dev/contextualai/apis/endpoints/changes/datastores/:datastore_id/documents/get)