List documents
Retrieves a paginated list of documents with their metadata and workflow status
Body ParametersJSONExpand Collapse
Optional tags this document should be containerized by. This can be an ID for your user, a project ID, or any other identifier you wish to use to group documents.
Filter documents by filepath. Exact match for full paths, prefix match if ending with /
filters: optional object { OR } or object { AND } Optional filters to apply to the search. Can be a JSON string or Query object.
Optional filters to apply to the search. Can be a JSON string or Query object.
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } Array of OR filter expressions
Array of OR filter expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } Array of AND filter expressions
Array of AND filter expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
ReturnsExpand Collapse
memories: array of object { id, connectionId, createdAt, 11 more }
Optional ID of connection the document was created from. This is useful for identifying the source of the document.
Optional custom ID of the document. This could be an ID from your database that will uniquely identify this document.
metadata: string or number or boolean or 2 moreOptional metadata for the document. This is used to store additional information about the document. You can use this to store any additional information you need about the document. Metadata can be filtered through. Keys must be strings and are case sensitive. Values can be strings, numbers, or booleans. You cannot nest objects.
Optional metadata for the document. This is used to store additional information about the document. You can use this to store any additional information you need about the document. Metadata can be filtered through. Keys must be strings and are case sensitive. Values can be strings, numbers, or booleans. You cannot nest objects.
List documents
curl https://api.supermemory.ai/v3/documents/list \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
-d '{
"limit": 10,
"order": "desc",
"page": 1,
"sort": "createdAt"
}'{
"memories": [
{
"id": "acxV5LHMEsG2hMSNb4umbn",
"connectionId": "xxxxxxxxxxxxxxxxxxxxxx",
"createdAt": "2025-04-15T09:30:00.000Z",
"customId": "doc-api-rate-limits",
"filepath": "filepath",
"metadata": {
"source": "bar",
"language": "bar"
},
"status": "done",
"summary": "API rate limit policy: 100 req/min free, 1000 req/min pro.",
"title": "API Rate Limiting Policy",
"type": "text",
"updatedAt": "2025-04-15T09:31:00.000Z",
"containerTags": [
"string"
],
"content": "This is the content of the document...",
"url": "https://docs.example.com/guides/rate-limits"
}
],
"pagination": {
"currentPage": 1,
"totalItems": 100,
"totalPages": 10,
"limit": 10
}
}Returns Examples
{
"memories": [
{
"id": "acxV5LHMEsG2hMSNb4umbn",
"connectionId": "xxxxxxxxxxxxxxxxxxxxxx",
"createdAt": "2025-04-15T09:30:00.000Z",
"customId": "doc-api-rate-limits",
"filepath": "filepath",
"metadata": {
"source": "bar",
"language": "bar"
},
"status": "done",
"summary": "API rate limit policy: 100 req/min free, 1000 req/min pro.",
"title": "API Rate Limiting Policy",
"type": "text",
"updatedAt": "2025-04-15T09:31:00.000Z",
"containerTags": [
"string"
],
"content": "This is the content of the document...",
"url": "https://docs.example.com/guides/rate-limits"
}
],
"pagination": {
"currentPage": 1,
"totalItems": 100,
"totalPages": 10,
"limit": 10
}
}