beel_list_series
List invoice series for a company by NIF, filter by active status and document type, and retrieve paginated or full results.
Instructions
Returns the invoice series of a company (NIF), optionally filtered by active and by
document_type — a document_type filter always includes the UNASSIGNED series, which
are compatible with any type.
Pagination is opt-in here: send page and/or limit to receive a single page plus a
data.pagination block with the totals. Omit both and the response carries the full list
in data.series and no pagination block.
Endpoint: GET /v1/companies/{company_id}/series
⚠️ Fiscal guardrails — read before calling:
How invoice numbers are formed, and why numbering can never be rewritten. (resource: beel://guardrails/series-and-numbering)
For the exhaustive rules and worked examples, call beel_docs_search.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (starts at 1). Omit for the full, unpaginated list. | |
| limit | No | Items per page. Omit for the full, unpaginated list. | |
| active | No | Filters by activity: `true` returns only active series, `false` only inactive ones. Omit it and you get **all** the series, active and inactive. | |
| company_id | Yes | NIF (company) the operation acts on. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A NIF you do not reach answers `403`, and so does a NIF that does not exist, so the existence of a NIF in another account is never disclosed. | |
| document_type | No | Filter by document type (UNASSIGNED series are always included) |