list_documents
List Holded documents by type with cursor pagination, optional field projection, and summary-only counts for lighter responses.
Instructions
List documents of a specific type (Holded API v2). Cursor-paginated: pass the previous response nextCursor as cursor. Response fields are snake_case; amounts are strings with decimal comma. NOTE: purchaserefund is not listable in v2 — only creation is supported (POST /purchases/refund).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"docType": "<docType>"
},
"name": "list_documents"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max items per page (server-paginated; use limit to control page size) | |
| cursor | No | Cursor from a previous response nextCursor for the next page | |
| fields | No | Project only these fields per item (e.g. ["id", "contact_name", "total"]). Reduces response size. | |
| docType | Yes | Type of document to list | |
| summary | No | Return only count and pagination metadata without items (default: false) |