Show an Invoice

GET https://app.alaaqat.com/api/invoices/{invoice_id}

Where invoice_id is the invoice's _id. Returns one invoice. Your API key needs the invoice-show ability.

Header

{
    "Accept": "application/json"
}

Response

200 OK, with the invoice under data and its property values under data.properties. The line items are under data.items. A property with no value is left out.

The IDs of the records linked to the invoice are under contact_ids, deal_ids and the like, and their number under contacts_count, deals_count and the like. See Associations.

{
    "data": {
        "properties": {
            "_id": "6657c1d2e3f4a5b6c7d8e901",
            "title": "Office chairs, October order",
            "status": "open",
            "currency": "JOD",
            "discount_rate": 5,
            "tax_rate": 16,
            "invoice_number": "INV-1001",
            "amount": 523.45,
            "created_by": 12,
            "updated_at": "2026-10-20T09:30:00.000000Z",
            "created_at": "2026-10-20T09:30:00.000000Z",
            "contact_ids": [
                "6650f1a2b3c4d5e6f7a8b901"
            ],
            "contacts_count": 1
        },
        "account_id": 1024,
        "items": [
            {
                "net_price": 440,
                "name": "Ergonomic office chair",
                "unit_price": 120,
                "quantity": 4,
                "description": "Black mesh back",
                "unit_discount": 10,
                "tax_rate": 0
            },
            {
                "net_price": 35,
                "name": "Delivery and assembly",
                "unit_price": 35,
                "quantity": 1,
                "description": null,
                "unit_discount": 0,
                "tax_rate": 0
            }
        ]
    }
}

Errors

Status Meaning
403 The invoice exists, but the team member who created the key can only see the invoices they or their teams own, and this one isn't.
404 No invoice with this _id in your account.