Sign in
Documents

Batch get documents by IDs

Batch retrieve multiple documents by their IDs.

Returns documents and a list of IDs that were not found. Maximum 1000 document IDs per request.

post/v1/documents/batch-get

Request body

document_idsstring[] required

List of document IDs to retrieve.

return_presigned_urlsboolean

Generate presigned download URLs for document blobs.

Response

Successful Response

not_foundstring[]

Document IDs that were not found.

Example response

{
  "documents": [
    {
      "_internal": {
        "collection_id": "col_articles",
        "created_at": "2025-10-31T10:00:00Z",
        "document_id": "doc_f8966ff29c18e20c6b45e053",
        "internal_id": "org_abc123",
        "lineage": {
          "chain": [
            {
              "collection_id": "col_articles",
              "feature_extractor_id": "text_extractor_v1",
              "timestamp": "2025-10-31T10:00:00Z"
            }
          ],
          "path": "bkt_content/col_articles",
          "root_bucket_id": "bkt_content",
          "root_object_id": "obj_article_001",
          "source_object_id": "obj_article_001",
          "source_type": "bucket"
        },
        "metadata": {
          "ingestion_status": "COMPLETED"
        },
        "modality": "text",
        "namespace_id": "ns_xyz789",
        "source_blobs": [
          {
            "blob_id": "blob_text_001",
            "blob_property": "content",
            "blob_type": "text"
          }
        ],
        "updated_at": "2025-10-31T10:00:00Z"
      },
      "author": "Dr. Smith",
      "collection_id": "col_articles",
      "description": "Text document with _internal structure",
      "document_id": "doc_f8966ff29c18e20c6b45e053",
      "title": "AI in Healthcare"
    }
  ]
}

Changes

Changed in 2 of the 29 revisions of this API.11

  • 1c7f318214241See the full diff
    • ●

      added the new signal enum value to the documents/items/_internal/anyOf[subschema #1: InternalPayloadModel]/lineage/anyOf[subschema #1: InternalLineageModel]/source_type/anyOf[subschema #1]/ response property for the response status 200

      response-property-enum-value-added

  • 5d4c905106b41See the full diff
    • ○

      the endpoint scheme security BearerAuth AND NamespaceHeader was added to the API

      api-security-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog