List invoices - HQ Rental Software

Returns the invoices of the account, newest issue date first, with their contact, tax, unpaid amount and lines. Unlike "Get an invoice", the response is a page of results without the success envelope. A draft invoice or credit note that has not been issued yet holds no number: its invoice_number is null and its full_number is the placeholder DRAFT, translated to the request's language (BORRADOR in Spanish), so check for a null invoice_number to tell a draft apart.

Responses

🟢200OK

application/json

A page of invoices. A successful body has no success field. HTTP 200 is also used for failures: such a body has success: false and is an ErrorUnauthorized (status_code 401 or 403).

Bodyapplication/json

Example

{
    "current_page": 1,
    "data": [
        {
            "id": 1024,
            "invoice_number": 1024,
            "prefix": "INV-",
            "full_number": "INV-001024",
            "uuid": "4b0d2f7e-8a51-4c3e-9f0a-2d6c1e9b7a35",
            "status": "partial",
            "type": "invoice",
            "issued_on": "2026-10-06T00:00:00.000000Z",
            "due_date": "2026-11-05T00:00:00.000000Z",
            "paid_on": null,
            "po_number": "PO-7781",
            "currency": "usd",
            "contact_type": "contacts",
            "contact_id": 30,
            "label": "Jane Doe",
            "first_name": "Jane",
            "last_name": "Doe",
            "email": "jane.doe@example.com",
            "tax_id": 2,
            "tax_name": "Sales tax",
            "subtotal": "250.0000",
            "total_tax": "17.5000",
            "total_discount": "0.0000",
            "total_amount": "267.5000",
            "total_paid": "100.0000",
            "notes": "Thank you for your business.",
            "terms": "Payment due within 30 days.",
            "item_type": "car_rental.reservations",
            "item_id": 1052,
            "created_at": "2026-10-06T14:02:11.000000Z",
            "updated_at": "2026-10-06T15:20:43.000000Z",
            "contact_label": "Jane Doe",
            "contact": {
                "id": 30,
                "label": "Jane Doe",
                "first_name": "Jane",
                "last_name": "Doe",
                "email": "jane.doe@example.com",
                "phone_number": "+1 305 555 0100"
            },
            "tax_object": {
                "id": 2,
                "name": "Sales tax",
                "value": "7.0000",
                "type": "sales",
                "eu_vat_category": "S",
                "accounting_code": null,
                "is_default": false
            },
            "total_unpaid": "167.5000",
            "product_invoice": [
                {
                    "id": 5310,
                    "invoice_id": 1024,
                    "product_id": 12,
                    "product_name": "Weekly rental - Economy",
                    "product_description": "Toyota Corolla or similar",
                    "quantity": 1,
                    "price": "250.00",
                    "subtotal": "250.00",
                    "tax": "7.00",
                    "total": "267.50",
                    "tax_id": 2,
                    "tax_name": "Sales tax",
                    "taxable": true,
                    "start_date": "2026-10-06T00:00:00.000000Z",
                    "end_date": "2026-10-13T00:00:00.000000Z",
                    "item_type": null,
                    "item_id": null,
                    "tax_object": {
                        "id": 2,
                        "name": "Sales tax",
                        "value": "7.0000",
                        "type": "sales",
                        "eu_vat_category": "S",
                        "accounting_code": null,
                        "is_default": false
                    }
                }
            ]
        }
    ],
    "first_page_url": "https://api.hqrentals.app/api/invoices/invoices?page=1",
    "from": 1,
    "last_page": 1,
    "last_page_url": "https://api.hqrentals.app/api/invoices/invoices?page=1",
    "links": [],
    "next_page_url": null,
    "path": "https://api.hqrentals.app/api/invoices/invoices",
    "per_page": 50,
    "prev_page_url": null,
    "to": 1,
    "total": 1
}

🟠400Bad Request