Retrieves invoice details by ID.
Grouped Invoices: If the invoice is a combined/grouped invoice, this endpoint returns all child invoices in the group.
Response Fields
| Field | Type | Description |
|---|---|---|
| id | integer | Unique invoice identifier. |
| hash_id | string | Invoice hash for optimistic locking. Use this value in PATCH requests. |
| parent_id | integer | Parent invoice ID for grouped invoices. Null if not grouped. |
| supplier_info | object | Supplier details (name, web, email, phone_number, address, supplierId). |
| ship_to | object | Ship-to address (name, address). |
| bill_to | object | Bill-to address (name, address, memo, departmentId, entityId). |
| invoice_number | string | Invoice number from the document. |
| po_number | string | Purchase order number. |
| invoice_terms | string | Payment terms (e.g., "Net 30"). |
| invoice_date | string | Invoice date (YYYY-MM-DD). |
| invoice_due | string | Payment due date (YYYY-MM-DD). |
| invoice_items | array | Line items (see below). |
| invoice_total | number | Total invoice amount. |
| tags | string | Comma-separated tags. |
| rejected | string | Rejection timestamp. Null if not rejected. |
| approved | string | Approval timestamp. Null if not approved. |
| approvers | array | List of users who acted on this invoice. |
| document | object | Document metadata (url, name, size). Null if no document. |
| modified | string | Last modification timestamp. |
| created | string | Creation timestamp. |
| integration_id | integer | Accounting integration ID. Null if not linked. |
| integration_api_id | string | Synced record API ID in the accounting system. Null if not synced. |
Line Item fields: id, qty, price, total, description, sku, itemId, customerId, accountId, classId, poId, poLineId, billable, departmentId, entityId, taxId, taxInclusive
Approver fields: id (integer or array of integers), name, approved, rejected, rejected_note
Enter your API token.
The unique identifier of the invoice to retrieve.
Invoice retrieved successfully
Single Invoice
{
"status": "OK",
"msg": "Record found",
"result": [
{
"id": 12345,
"hash_id": "abc123def456",
"parent_id": null,
"supplier_info": {
"name": "Acme Corp",
"web": "https://acme.com",
"email": "billing@acme.com",
"phone_number": "+1-555-123-4567",
"address": "123 Main St, New York, NY 10001",
"supplierId": "SUP-001"
},
"ship_to": {
"name": "Warehouse A",
"address": "456 Oak Ave, Los Angeles, CA 90001"
},
"bill_to": {
"name": "Accounts Payable",
"address": "789 Corporate Blvd, Chicago, IL 60601",
"memo": "Attn: John Smith",
"departmentId": "DEPT-100",
"entityId": null
},
"invoice_number": "INV-2024-001",
"po_number": "PO-789",
"invoice_terms": "Net 30",
"invoice_date": "2024-01-15",
"invoice_due": "2024-02-14",
"invoice_items": [
{
"id": "1",
"qty": 10,
"price": 100.0,
"total": 1000.0,
"description": "Professional Services - January 2024",
"sku": "SVC-001",
"itemId": null,
"customerId": null,
"accountId": "EXP-100",
"classId": "CLASS-100",
"poId": null,
"poLineId": null,
"billable": true,
"departmentId": "DEPT-100",
"entityId": null,
"taxId": null,
"taxInclusive": false
},
{
"id": "2",
"qty": 5,
"price": 100.0,
"total": 500.0,
"description": "Consulting Hours",
"sku": "SVC-002",
"itemId": null,
"customerId": "CUST-001",
"accountId": null,
"classId": null,
"poId": "PO-789",
"poLineId": "PO-789-1",
"billable": true,
"departmentId": null,
"entityId": null,
"taxId": null,
"taxInclusive": false
}
],
"invoice_total": 1500.0,
"tags": "verified,q1-2024",
"rejected": null,
"approved": "2024-01-16T14:30:00Z",
"approvers": [
{
"id": 42,
"name": "John Smith",
"approved": "2024-01-16T14:30:00Z",
"rejected": null,
"rejected_note": null
}
],
"document": {
"url": "https://storage.makershub.ai/invoices/abc123.pdf",
"name": "invoice-2024-001.pdf",
"size": 245678
},
"modified": "2024-01-16T14:30:00Z",
"created": "2024-01-15T10:00:00Z",
"integration_id": 3,
"integration_api_id": "1234"
}
]
}Complete invoice object returned by the GET endpoint.
Unique invoice identifier.
Invoice hash for optimistic locking. Use this value in PATCH requests.
Parent invoice ID for grouped invoices. Null if not grouped.
Supplier/vendor information.
Supplier name.
Supplier website URL.
Supplier email address.
Supplier phone number.
Supplier address.
External supplier/vendor ID reference.
Ship-to address information.
Ship-to name.
Ship-to address.
Bill-to address information.
Bill-to name.
Bill-to address.
Memo or notes for the bill-to.
Department reference ID.
Entity reference ID.
Invoice number from the document.
Purchase order number.
Payment terms (e.g., "Net 30").
Invoice date (YYYY-MM-DD).
Payment due date (YYYY-MM-DD).
Line items on the invoice.
Line item as returned in GET responses. Includes all fields from InvoiceLineItem plus response-specific data.
Line item identifier.
Quantity.
Unit price.
Line total.
Item description.
Item SKU.
Reference to item master record.
Customer reference for billable items.
GL account reference ID.
Accounting class reference ID.
Purchase order reference ID.
Purchase order line reference ID.
Whether line item is billable.
Department reference ID.
Entity reference ID.
Tax code reference ID.
Whether price includes tax.
Total invoice amount.
Comma-separated tags.
Rejection timestamp. Null if not rejected.
Approval timestamp. Null if not fully approved.
List of users who have acted on this invoice.
User who has acted on the invoice approval workflow.
User ID. Can be a single integer or an array of integers for grouped approvers.
User's display name.
Timestamp when user approved. Null if not approved.
Timestamp when user rejected. Null if not rejected.
Note provided when rejecting.
Document/file attachment metadata. Null if no document attached.
URL to download the document.
Original filename.
File size in bytes.
Last modification timestamp.
Creation timestamp.
Accounting integration ID. Null if not linked to an integration.
Synced record API ID in the accounting system. Null if not synced.
Bad Request - Invalid invoice ID format
Invalid ID
{
"status": "Error",
"msg": "Invalid invoice ID",
"result": null
}Unauthorized - Missing or invalid API token
Invoice not found
Not Found
{
"status": "Error",
"msg": "Invoice not found",
"result": null
}