Invoices

List invoices

Retrieve a paginated list of invoices with optional filters for status, date range, and search.

get/v1/invoices

Request

  • Base URL: https://api.frihet.io
  • URL: https://api.frihet.io/v1/invoices
  • Auth: API key in header X-API-Key

Query parameters

limitinteger

Number of items to return (default 50, max 100)

offsetinteger

Number of items to skip for pagination (max 10000)

cursorstring
Example:eyJpc3N1ZURhdGUiOiIyMDI2LTAzLTIwIiwiX19pZCI6ImFiYzEyMyJ9

Cursor for cursor-based pagination. Use the nextCursor value from a previous response to fetch the next page. When provided, offset is ignored. The cursor is a base64url-encoded JSON string.

status'draft' | 'sent' | 'partial' | 'paid' | 'overdue' | 'cancelled'

Filter by invoice status

fromstring date
Example:2026-01-01

Start date filter in ISO format (YYYY-MM-DD)

tostring date
Example:2026-12-31

End date filter in ISO format (YYYY-MM-DD)

qstring
Example:acme

Full-text search query. Searches across relevant fields per resource type (e.g., clientName, documentNumber for invoices; name, email for clients). Case-insensitive.

fieldsstring
Example:id,name,total

Comma-separated list of fields to include in the response. The id field is always included. Example: fields=id,name,total

clientIdstring

Filter invoices or quotes by client ID

seriesIdstring

Filter invoices or quotes by invoice series ID

Response

A paginated list of invoices

totalinteger

Total number of items matching the query

limitinteger

Number of items per page

offsetinteger

Current offset

nextCursorstring

Cursor for fetching the next page of results. Only present when there are more results available. Pass this value as the cursor query parameter in the next request. Base64url-encoded.

truncatedboolean

Only present (and true) when the underlying search query saturated the internal 500-document cap. total therefore reports the size of the first 500 matches, not the full match count. Narrow the search query (taxId / fiscal id, exact email) to ensure you see every result.

Example response

{
  "data": [
    {
      "id": "abc123def456",
      "clientId": "client_abc123",
      "clientName": "Acme Corp",
      "clientTaxId": "B12345678",
      "clientAddress": "Calle Mayor 12, 38001 Santa Cruz de Tenerife",
      "clientLocation": "canarias",
      "documentNumber": "FAC-2026-0042",
      "items": [
        {
          "description": "Web development services",
          "quantity": 10,
          "unitPrice": 85
        }
      ],
      "issueDate": "2026-03-09",
      "dueDate": "2026-04-09",
      "notes": "Payment due within 30 days",
      "taxRate": 21,
      "irpfRate": 15,
      "discountRate": 10,
      "recurring": {
        "enabled": true,
        "frequency": "monthly",
        "nextDate": "2026-04-01",
        "endDate": "2027-03-31",
        "maxOccurrences": 12
      },
      "subtotal": 850,
      "tax": 178.5,
      "total": 1028.5,
      "currency": "EUR"
    }
  ],
  "nextCursor": "eyJpc3N1ZURhdGUiOiIyMDI2LTAzLTIwIiwiX19pZCI6ImFiYzEyMyJ9",
  "truncated": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.