GET Single Invoice

Production

https://{{subdomain}}.daftra.com/api2

GET

/invoices/{id}{format}

Returns a single standard invoice by id, with full nested detail — line items, payments, taxes, documents, custom fields and the client — in one response (no recursive flag needed).

Only standard invoices (document type Invoice) are returned here; an id belonging to another document type (estimate, credit note, debit note, refund, …) returns 404 Invoice not found — use that type's own single-resource endpoint instead.

Requires permission to view the invoice (all-invoices access, or being the invoice's own staff, plus invoice-details access).

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Responses

🟢200OK

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://.daftra.com/api2/invoices/' \
--header 'Accept: application/json' \
--header 'apikey: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

Response Example

200 - Example 1

{
    "code": 200,
    "result": "successful",
    "data": {
        "Invoice": {
            "id": 26,
            "staff_id": 0,
            "subscription_id": null,
            "store_id": 0,
            "type": "0 => Invoice",
            "no": "0700000AAAAA0001",
            "po_number": 26,
            "name": "string",
            "branch_id": 0,
            "client_id": 15,
            "is_offline": true,
            "currency_code": "USD",
            "client_business_name": "Example Client",
            "client_first_name": "Example",
            "client_last_name": "Client",
            "client_email": "client@example.com",
            "client_address1": "string",
            "client_address2": "string",
            "client_postal_code": "string",
            "client_city": "string",
            "client_state": "string",
            "client_country_code": "EG",
            "date": "2018-11-07",
            "payment_status": "null => Unpaid",
            "draft": "0",
            "discount": 0,
            "discount_amount": 0,
            "deposit": 0,
            "deposit_type": 0,
            "summary_subtotal": 0,
            "summary_discount": 0,
            "summary_total": 0,
            "summary_paid": 0,
            "summary_unpaid": 0,
            "summary_deposit": 0,
            "summary_refund": 0,
            "notes": "string",
            "html_notes": "string",
            "created": "2018-11-07",
            "modified": "2018-11-07",
            "invoice_layout_id": 1,
            "estimate_id": "The primary store id",
            "shipping_options": "",
            "shipping_amount": null,
            "client_active_secondary_address": true,
            "client_secondary_name": "string",
            "client_secondary_address1": "string",
            "client_secondary_address2": "string",
            "client_secondary_city": "string",
            "client_secondary_state": "string",
            "client_secondary_postal_code": "string",
            "client_secondary_country_code": "string",
            "follow_up_status": null,
            "work_order_id": null,
            "requisition_delivery_status": null,
            "pos_shift_id": null,
            "source_type": null,
            "source_id": null,
            "qr_code_url": "https://yoursite.daftra.com/qr/?d64=QVE1TmIyaGhiV1ZrSUVGemFISmhaZ0lJTVRFMU16WTJRMUlERkRJd01qSXRNVEF0TWpoVU1EQTZNREU2TVRWYUJBRXdCUUV3",
            "invoice_html_url": "https://yoursite.daftra.com/invoices/preview/2621?hash=c06543fe13bd4850b521733687c53259",
            "invoice_pdf_url": "https://yoursite.daftra.com/invoices/view/2621.pdf?hash=c06543fe13bd4850b521733687c53259",
            "Client": {
                "id": 512,
                "is_offline": true,
                "client_number": "0000715",
                "staff_id": 0,
                "business_name": "John Smith",
                "first_name": "",
                "last_name": "",
                "email": "user@example.com",
                "address1": "string",
                "address2": "string",
                "city": "string",
                "state": "string",
                "postal_code": "string",
                "phone1": "string",
                "phone2": "string",
                "country_code": "str",
                "notes": "string",
                "active_secondary_address": true,
                "secondary_name": "string",
                "secondary_address1": "string",
                "secondary_address2": "string",
                "secondary_city": "string",
                "secondary_state": "string",
                "secondary_postal_code": "string",
                "secondary_country_code": "string",
                "default_currency_code": "strin",
                "last_login": "2018-05-10 00:42:00",
                "suspend": true,
                "last_ip": "127.0.0.1",
                "created": "2018-05-10 00:42:00",
                "modified": "2018-05-12 13:05:06",
                "follow_up_status": null,
                "category": "string",
                "group_price_id": 0,
                "timezone": 0,
                "bn1": "string",
                "bn1_label": "string",
                "bn2_label": "string",
                "bn2": "string",
                "starting_balance": null,
                "type": null,
                "birth_date": "2018-05-10",
                "gender": null,
                "map_location": null,
                "credit_limit": 0,
                "credit_period": 0,
                "branch_id": 1
            },
            "InvoiceItem": [
                {
                    "id": 0,
                    "invoice_id": 0,
                    "item": "string",
                    "description": "string",
                    "unit_price": 0,
                    "quantity": 0,
                    "tax1": 0,
                    "tax2": 0,
                    "summary_tax1": 0,
                    "summary_tax2": 0,
                    "subtotal": 0,
                    "product_id": 0,
                    "col_3": null,
                    "col_4": null,
                    "col_5": null,
                    "created": "2018-05-10 00:42:00",
                    "modified": "2018-05-12 13:05:06",
                    "discount": 0,
                    "discount_type": "1 => Percentage",
                    "store_id": "The invoice store id",
                    "calculated_discount": 0
                }
            ],
            "InvoicePayment": [
                {
                    "id": 0,
                    "invoice_id": 0,
                    "payment_method": "string",
                    "amount": 0,
                    "transaction_id": "string",
                    "treasury_id": 0,
                    "date": "2019-08-24T14:15:22.123Z",
                    "email": "string",
                    "status": 0,
                    "notes": "string",
                    "response_code": "string",
                    "response_message": "string",
                    "created": "2019-08-24T14:15:22.123Z",
                    "modified": "2019-08-24T14:15:22.123Z",
                    "currency_code": "str",
                    "first_name": "string",
                    "last_name": "string",
                    "address1": "string",
                    "address2": "string",
                    "city": "string",
                    "state": "string",
                    "postal_code": "string",
                    "country_code": "str",
                    "phone1": "string",
                    "phone2": "string",
                    "transaction_type": "string",
                    "processed": true,
                    "attachment": "string",
                    "staff_id": 0,
                    "receipt_notes": "string"
                }
            ],
            "InvoiceCustomField": {},
            "Deposit": {},
            "InvoiceReminder": {},
            "Document": {},
            "DocumentTitle": {}
        }
    },
    "pagination": {
        "prev": "/api2/clients/?page=1",
        "next": "/api2/clients/?page=3",
        "page": 2,
        "page_count": 5,
        "total_results": 98
    }
}

GET All Invoices

Edit Invoices