Search the archive (status)

Polling snapshot: the same current record or collection as the corresponding read endpoint, including its state and progress. List filters, defaults and pagination also apply here. This is not an event history or a changes-since feed. Poll at a sensible interval (start with 30 seconds), respect Retry-After on 429 and stop when the required terminal state is reached.

Find documents. Combines free text, document type, direction, pipeline status, a date window and metadata field filters in ONE call — prefer it over listing everything and filtering yourself. Free text is ranked and matches the title, the extracted fields and the converted body; the last word is treated as a prefix, so a half-typed word still matches. With free text each document carries page: the page of the file the words are on (null when the file has no pages) — cite it, and read around it with documents_get_content. Every document carries untrusted_summary: two or three lines on what it is (who, what, about what), written when it was processed — read the summaries to pick the right document, and to say what a document is without opening it; null until it has been processed. Returns at most 100 rows per call; page with cursor. Prefer several narrow searches over one broad one.

Examples

• Find the invoices from Rossi over €5.000 last quarter GET /api/v1/rest/documents/status?type=fattura_entrata&from=2026-04-01&to=2026-06-30&metadata=%5B%7B%22field%22%3A%22fornitore%22%2C%22op%22%3A%22contains%22%2C%22kind%22%3A%22text%22%2C%22value%22%3A%22Rossi%22%7D%2C%7B%22field%22%3A%22totale%22%2C%22op%22%3A%22gt%22%2C%22kind%22%3A%22number%22%2C%22value%22%3A5000%7D%5D
• What did we file about the Bianchi contract? GET /api/v1/rest/documents/status?query=contratto+Bianchi