List your invoices and their status

View your invoices, including their payment status. This is useful when you want an overview of your outstanding or paid invoices. The API also returns IDs needed for follow-up actions, such as a `currency_id` used to call POST /api/account/currency, or an `invoiceId` to initiate a payment via POST /api/billing/pay.

Billing & Payments Invoices

Context

Used in the dashboard

/cost-management /billing

Workflow links

Produces

Headers

Accept Example
Content-Type Example

Body

required
application/json
filters object required
skipCache boolean · Example: false

Responses

200
data object required
data.currentPage integer required · Example: 1
data.hasMore boolean required · Example: false
data.invoices array<object> required · Example: [{"id":"50676","locked":"0","currency_id":"0","date":"2026-01-19","dateorig":"2026-01-1...
data.invoices[].client_id string required · Example: 30000
data.invoices[].companyname string required · Example: Example AB
data.invoices[].credit string required · Example: 0.00
data.invoices[].currency_id string required · Example: 0
data.invoices[].date string required · Example: 2026-01-19
data.invoices[].dateorig string required · Example: 2026-01-19
data.invoices[].datepaid string required · Example: 0000-00-00 00:00:00
data.invoices[].duedate string required · Example: 2026-02-18
data.invoices[].firstname string required · Example: Anna
data.invoices[].flags string required · Example: 0
data.invoices[].formatted_id string required · Example: 202650676
data.invoices[].grandtotal string required · Example: 256.25
data.invoices[].group_id string required · Example: 0
data.invoices[].id string required · Example: 50676
data.invoices[].lastname string required · Example: Svensson
data.invoices[].locked string required · Example: 0
data.invoices[].module string · enum required · Example: Invoice
Invoice
Kortbetalning
Stripe Checkout
Swish
data.invoices[].paid_id string required · Example:
data.invoices[].paybefore string required · Example: 2026-02-18
data.invoices[].recid string required · Example: 0
data.invoices[].status string · enum required · Example: Unpaid
Paid
Unpaid
data.invoices[].subtotal2 string required · Example: 256.25
data.invoices[].total string required · Example: 256.25
data.pages integer required · Example: 0
data.success boolean required · Example: true

True for successful responses.

data.total string required · Example: 0
requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

POST https://cloud.hostup.se/api/billing/invoices
For AI assistants
cURL 
curl -X POST "https://cloud.hostup.se/api/billing/invoices" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "status": "Unpaid",
      "limit": 1000,
      "page": 0
    }
  }'
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "invoices": [],
    "hasMore": false,
    "total": "0",
    "pages": 0,
    "currentPage": 1,
    "success": true
  }
}
Request Body Example 1 
{
  "filters": {
    "status": "Unpaid",
    "limit": 1000,
    "page": 0
  }
}