List Documents

List accessible documents with metadata filtering.

Supported operators: $and, $or, $nor, $not, $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $exists, $type, $regex, $contains.

Implicit equality (backwards compatible):

{"status": "active"}

Uses JSONB containment, matches scalars inside arrays, JSON-serializable types only.

Explicit operators (typed comparisons):

{"priority": {"$eq": 42}, "created_date": {"$gte": "2024-01-01T00:00:00Z"}}

Supports typed metadata (number, decimal, datetime, date) with safe casting.

POST /documents

Try it

JavaScript

JavaScript

import Morphik from 'morphik';

const client = new Morphik({
  apiKey: 'My API Key',
});

const documents = await client.documents.list();

console.log(documents);

200

[
  {
    "content_type": "<string>",
    "external_id": "<string>",
    "filename": "<string>",
    "metadata": {},
    "metadata_types": {},
    "storage_info": {},
    "storage_files": [
      {
        "bucket": "<string>",
        "key": "<string>",
        "version": 1,
        "filename": "<string>",
        "content_type": "<string>",
        "timestamp": "2023-11-07T05:31:56Z"
      }
    ],
    "system_metadata": {},
    "additional_metadata": {},
    "chunk_ids": [
      "<string>"
    ],
    "folder_name": "<string>",
    "end_user_id": "<string>",
    "app_id": "<string>"
  }
]

Headers

authorization · string

Query Parameters

folder_name

end_user_id · string | null

Body

application/json

Request model for listing documents

document_filters · Document Filters · object

Metadata filters with operator support: $and, $or, $nor, $not, $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $exists, $type, $regex, $contains. Implicit equality uses JSONB containment; explicit operators support typed comparisons.

skip · integer · default: 0

Number of documents to skip before returning results.

Required range: x >= 0

limit · integer · default: 1000

Maximum number of documents to return.

Response

200

application/json

Successful Response

content_type · string · required

external_id · string

filename · string | null

metadata · Metadata · object

metadata_types · Metadata Types · object

Show child attributes

metadata_types. {key} · string

storage_info · Storage Info · object

storage_files · StorageFileInfo · object[]

Show child attributes

storage_files. bucket · string · required

storage_files. key · string · required

storage_files. version · integer · default: 1

storage_files. filename · string | null

storage_files. content_type · string | null

storage_files. timestamp · string<date-time>

system_metadata · System Metadata · object

additional_metadata · Additional Metadata · object

chunk_ids · string[]

folder_name · string | null

end_user_id · string | null

app_id · string | null