List all quotes
List your sales quotes with cursor-based pagination. Supports filtering by status[in], client_id, issued_on[gte|lte].
Request
- Base URL: https://api.factuarea.com/v1
- URL: https://api.factuarea.com/v1/companies/{company}/quotes
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Path parameters
Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).
Query parameters
Number of objects to return, between 1 and 100 (default 25).
Cursor for forward pagination: pass the id of the last object on the previous page (the next_cursor of the previous response).
Cursor for backward pagination: pass the id of the first object on the current page.
Quote status. Exact match on status.
Comma-separated list of values (CSV).
Quote status. Comma-separated list. Any of the values matches.
Client ID (UUID v7). Exact match on client_id.
Comma-separated list of values (CSV).
Client ID (UUID v7). Comma-separated list. Any of the values matches.
Series ID (UUID v7). Exact match on series_id.
Comma-separated list of values (CSV).
Series ID (UUID v7). Comma-separated list. Any of the values matches.
Creation date (ISO 8601). Greater than or equal to the given value.
Creation date (ISO 8601). Less than or equal to the given value.
Creation date (ISO 8601). Strictly greater than the given value.
Creation date (ISO 8601). Strictly less than the given value.
Validity date. Greater than or equal to the given value.
Validity date. Less than or equal to the given value.
Validity date. Strictly greater than the given value.
Validity date. Strictly less than the given value.
Total amount. Greater than or equal to the given value.
Total amount. Less than or equal to the given value.
Total amount. Strictly greater than the given value.
Total amount. Strictly less than the given value.
Quote number. Exact match on number.
Quote number. Partial case-insensitive match (LIKE %term%) on number.
Classification tag (lowercase slug); tags[in]=a,b matches quotes carrying ANY of the tags. Exact match on tags.
Comma-separated list of values (CSV).
Classification tag (lowercase slug); tags[in]=a,b matches quotes carrying ANY of the tags. Comma-separated list. Any of the values matches.
Sort order: created, total, number, valid_until ascending, or with a - prefix for descending (default -created).
Free-text search. Escaped LIKE %term% (case-insensitive, max 80 chars) across the resource's key text columns, combined with the other filters (AND) and compatible with the cursor.
Metadata filter as metadata[key]=value (deepObject): pairs combine with AND, up to 50, keys matching [A-Za-z0-9_.-]{1,64}.
Headers
Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.
Response
Example response
{
"data": [
{
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a04",
"number": "P-2026-00012",
"series": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0e",
"code": "F-2026"
},
"client": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01",
"name": "Acme Corporation"
},
"status": "sent",
"issued_on": "2026-01-18",
"valid_until": "2026-02-17",
"converted_invoice_number": "F-2025-001",
"subtotal": "500.00",
"taxes_total": "105.00",
"total_vat": "105.00",
"total_retention": "0.00",
"total_surcharge": "0.00",
"total": "605.00",
"currency": "EUR",
"notes": "Presupuesto válido 30 días.",
"terms": "Presupuesto valido durante 30 dias desde la fecha de emision.",
"reference": "PRES-ANT-0012",
"operation_regime": "general",
"external_id": "CRM-PRES-2026-0012",
"lines": [
{
"description": "Auditoría inicial",
"additional_description": "Auditoría inicial e informe de mejoras",
"product": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a09",
"name": "Consultoría hora estándar"
},
"quantity": 5,
"unit_price": "100.0000",
"tax_rate": 21,
"subtotal": "500.00",
"taxes": "105.00",
"total": "605.00",
"counted_quantity": "4.0000",
"configuration": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8c02",
"name": "Auditoría · Alcance ampliado",
"signature": "b48d0e97c1a35f26708db4e9152c6af3d07be845913fc2607ad5e1b93840c26f"
},
"options": [
{
"group": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8c12",
"name": "Alcance"
},
"value": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8c22",
"name": "Ampliado"
},
"price_adjustment": "20.0000",
"applied": true
}
],
"price_semantics": "per_commercial_unit",
"price_adjustment_total": "20.0000"
}
],
"metadata": {
"erp_code": "IVA-GEN",
"ledger_account": "477000"
},
"tags": [
"comercial",
"q1-2026"
],
"custom_fields": [
{
"field": "campania",
"value": "Promo primavera"
}
],
"link_expires_at": "2026-07-01T09:53:57+02:00",
"link_is_active": true,
"created_at": "2026-01-18T16:20:00Z",
"updated_at": "2026-01-18T16:25:00Z"
}
],
"has_more": true,
"next_cursor": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0c"
}Changes
No recorded changes to this operation across all 1 revision of this API.