List bills

Returns a paginated list of the company's bills ("boletas/facturas de Cardda"):
the monthly billing documents that aggregate Cardda's commission charges.

Scope

Company users only see bills for companies they are a member of (via their
company memberships). Cardda staff see all bills.

Filtering, sorting, pagination

Supports the standard list controls: _start/_end for pagination,
_field/_order for sorting, and per-field filters. A filter value can be a
plain value (exact match) or a JSON string with an operator, e.g.
status={"$in":["issued","preissued"]}.

Response

Each bill includes charges_with_descriptions, a human-readable breakdown of the
per-product charges.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
≥ 0

If all the transactions where in an array, this would represent the index of the first item returned in the response

integer
≥ 0

If all the transactions where in an array, this would represent the index of the last item returned in the response

string
enum

The order method, which can be ascending or descending

Allowed:
string

The field used to sort, the example illustrates a response that would be sorted by the creation date

string

Filter by company UUID. Supports {"$in":[...]} for batch lookups.

string

Filter by bill status (e.g. draft, preissued, issued).

integer

Filter by billing month (1-12).

integer

Filter by billing year.

Headers
uuid
required

UUID of the company on whose behalf the request is made. Required for every Finance endpoint.
See The company-id header for details on how to obtain
a value for this header and the error responses to expect when it is missing or invalid.

Responses

401

Unauthorized - missing or invalid authentication token.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json