# List Estimates (POST) Same as GET /api/v3/estimates, with the filters sent as a JSON body instead of the query string (useful for long id / client_id lists). The response is identical. Page size defaults to 10. Endpoint: POST /api/v3/estimates Version: 3.1.0 Security: apiKeyAuth ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Request fields (application/json): - `page` (integer) Example: 1 - `per_page` (integer) Page size (default 10). Aliases: items_per_page, page_items. Example: 10 - `language` (string) Example: "pt" - `sort` (string) Example: "date" - `sort_order` (string) Enum: "asc", "desc" - `text` (string) Example: "John Doe" - `reference` (string) Example: "PO-999" - `archived` (boolean) - `non_archived` (boolean) - `fuid` (string) - `batch_id` (string) - `id` (array) - `except_id` (array) - `type` (array) Enum: "Quote", "Proforma", "FeesNote" - `status` (array) Enum: "draft", "sent", "accepted", "refused", "canceled", "deleted" - `client_id` (array) - `serie_name` (array) - `date` (object) Example: {"from":"2026-04-01","to":"2026-04-30"} - `date.from` (string,number) Example: "2026-04-01" - `date.to` (string,number) Example: "2026-04-30" - `valid_to` (object) - `total_before_taxes` (object) - `total_with_taxes` (object) ## Response 200 fields (application/json): - `estimates` (array) - `estimates.id` (integer) Example: 257118662 - `estimates.sequence_number` (string) Example: "INVOICEXPRESSDEMO/-" - `estimates.sequence` (string) Example: "INVOICEXPRESSDEMO" - `estimates.document_number` (string,null) - `estimates.type` (string) Example: "Quote" - `estimates.status` (string) Example: "draft" - `estimates.archived` (boolean) - `estimates.client_name` (string) Example: "Test Client API" - `estimates.reference` (string,null) The document's free-text reference, the same value the reference filter searches. null when the document has none. Example: "PO-1234" - `estimates.date` (string) Example: "2026-05-11 00:00:00 +0100" - `estimates.valid_to` (string) Example: "2026-06-11 00:00:00 +0100" - `estimates.total` (number) Example: 123 - `estimates.total_before_taxes` (number) Example: 100 - `estimates.final_date` (string,null) - `estimates.token` (string) Example: "2571186625ad1072ab31349f6c7c6bd919c2547e43c965aa1" - `estimates.legacy_invoice_receipt_config` (boolean,null) - `totals` (object) - `totals.count` (integer) Example: 1 - `totals.pages` (integer) Example: 1 - `totals.statuses` (array) Example: ["draft"] - `totals.total_due` (number) - `totals.total_due_with_taxes` (number) - `totals.total_overdue` (number) - `totals.total_overdue_with_taxes` (number) - `totals.total_drafts` (number) Example: 100 - `totals.total_drafts_with_taxes` (number) Example: 123 - `totals.total_accepted` (number) - `totals.total_accepted_with_taxes` (number) - `totals.total_refused` (number) - `totals.total_refused_with_taxes` (number) - `totals.total_canceled` (number) - `totals.total_canceled_with_taxes` (number) - `totals.total_taxes` (number) ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 500 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string) ## Response 503 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string)