Sign in
invoices

Retrieve detailed information for a specific invoice

Returns comprehensive details for a single invoice, including full metadata, vendor information, location, payment status, error details (if any), and export tracking status.

get/invoices/{id}

Path parameters

idstring required

Invoice ID - Unique identifier of the invoice to retrieve

Query parameters

expandstring

Comma-separated list of fields to expand. Options: history, gl_splits. Use history to include the full audit log. Use gl_splits to include GL account splits (real splits or virtual splits derived from line-item mappings).

Headers

Authorizationstring required

OAuth2 authentication flows. Auth server URLs will vary by environment

X-Api-Keystring required

API key for authentication

X-API-Versionstring

API version to use (optional, defaults to latest). Supported values: 1.0.0, 1.1.0.

Response

Successful response with invoice details

versionstring

API version

idstring required

Unique invoice identifier

invoice_numberstring

Invoice number from vendor

ottimate_vendor_namestring

Ottimate vendor name. With X-API-Version: 1.1.0 this is the human-readable vendor name.

ottimate_vendor_idinteger nullable

Ottimate vendor ID. For X-API-Version: 1.1.0 this is an integer matching the id returned by GET /vendors (usable with GET /vendors/{id}); for 1.0.0/unversioned it is returned as a string (the operational vendor id). Null when the invoice has no vendor mapping.

erp_vendor_idstring

ERP vendor id (the accounting system's own vendor code).

erp_vendor_namestring

ERP vendor display name.

ottimate_location_namestring

Location name

ottimate_location_idstring

Ottimate location (restaurant) ID.

custom_fieldsInvoiceDetailObjectCustomFields

Custom header field key/value pairs configured for the company.

invoice_datestring date

Date invoice was issued

due_datestring date

Payment due date

total_amountnumber double

Total invoice amount

total_taxnumber double

Total tax amount

currencystring

Currency code (ISO 4217)

outstanding_balancenumber double

Remaining unpaid amount

type'invoice' | 'credit_memo' | 'other'

Type of invoice document

status'processing' | 'needs-attention' | 'pending-approval' | 'ready-for-export' | 'exported' | 'inactive' required

Invoice processing status

sub_status'deleted' | 'merged' | 'archived' | 'duplicate'

Reason why the invoice is inactive. Only present when status is 'inactive', null otherwise.

payment_status'paid' | 'partial' | 'unpaid' required

Payment status

purchase_orderstring

Associated purchase order number

created_atstring date-time required

Timestamp when invoice was created

created_at_utcstring date-time nullable

UTC equivalent of created_at. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".

approved_datestring date-time nullable

Date when invoice was approved

approved_date_utcstring date-time nullable

UTC equivalent of approved_date. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".

posting_datestring date nullable

Date when invoice was posted

exported_datestring date-time

Date when invoice was exported

exported_date_utcstring date-time nullable

UTC equivalent of exported_date. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".

errorstring

Error message if invoice is flagged

notesstring nullable

Free-text notes on the invoice.

image_errorsstring nullable

Errors encountered while processing/uploading invoice images, if any. Empty string when there are none.

urlstring

URL to view the invoice in the Ottimate dashboard

dimensionsInvoiceDetailObjectDimensions

Header-level dimension mappings. Contains accounting dimensions assigned to the invoice header (e.g., Department, Class, Location).

last_modified_datestring date-time nullable

Timestamp when invoice was last modified

last_modified_date_utcstring date-time nullable

UTC equivalent of last_modified_date. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".

Changes