Skip to main content
GET
/
invoices
curl "https://api.alguna.io/invoices?page=1&limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
    "items": [
        {
            "id": "ZVzWRFnt",
            "accountId": "aBsZxlLh",
            "currency": "USD",
            "description": "Platform subscription",
            "billingPeriodStart": "2024-02-01T00:00:00Z",
            "billingPeriodEnd": "2024-02-29T23:59:59Z",
            "status": "upcoming",
            "total": "200.00",
            "billingPeriod": "Feb 01, 24 - Feb 29, 24",
            "createdAt": "2024-01-24T16:36:52.78883Z",
            "updatedAt": "2024-01-26T19:30:37.734294Z"
        },
        {
            "id": "jqsKFrxO",
            "accountId": "JXvYcskd",
            "currency": "USD",
            "description": "Monthly seats",
            "billingPeriodStart": "2024-02-01T00:00:00Z",
            "billingPeriodEnd": "2024-02-29T23:59:59Z",
            "status": "upcoming",
            "total": "500.00",
            "billingPeriod": "Feb 01, 24 - Feb 29, 24",
            "createdAt": "2024-01-24T16:25:48.027798Z",
            "updatedAt": "2024-01-26T19:30:38.083477Z"
        }]
}

Documentation Index

Fetch the complete documentation index at: https://alguna.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Retrieves a paginated list of all invoices. You can filter and sort the results using query parameters.

​
Query Parameters

​
page
integer
default:"1"
The page number to retrieve (1-indexed).
​
limit
integer
default:"10"
The number of invoices to return per page. Must be one of: 5, 10, 25, 50, or 100. Values exceeding 100 are capped automatically.
​
filters
string
A JSON-encoded array of filter objects. Each filter object has the following properties:
​
sort
string
Sort specification in field:order format. Order is either asc (ascending) or desc (descending).Sortable fields: invoicing_date, issue_date, due_date, paid_date, account_name, status.
curl "https://api.alguna.io/invoices?page=1&limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
    "items": [
        {
            "id": "ZVzWRFnt",
            "accountId": "aBsZxlLh",
            "currency": "USD",
            "description": "Platform subscription",
            "billingPeriodStart": "2024-02-01T00:00:00Z",
            "billingPeriodEnd": "2024-02-29T23:59:59Z",
            "status": "upcoming",
            "total": "200.00",
            "billingPeriod": "Feb 01, 24 - Feb 29, 24",
            "createdAt": "2024-01-24T16:36:52.78883Z",
            "updatedAt": "2024-01-26T19:30:37.734294Z"
        },
        {
            "id": "jqsKFrxO",
            "accountId": "JXvYcskd",
            "currency": "USD",
            "description": "Monthly seats",
            "billingPeriodStart": "2024-02-01T00:00:00Z",
            "billingPeriodEnd": "2024-02-29T23:59:59Z",
            "status": "upcoming",
            "total": "500.00",
            "billingPeriod": "Feb 01, 24 - Feb 29, 24",
            "createdAt": "2024-01-24T16:25:48.027798Z",
            "updatedAt": "2024-01-26T19:30:38.083477Z"
        }]
}
​
items
array
List of invoice objects.
​
pageCount
integer
Total number of pages available based on the current limit.
​
limit
integer
The number of items per page used for this request.