GetInvoices
Use this function to retrieve one or many invoices.
Note:
- When you retrieve multiple invoices, only a summary of the contact is returned and no line details are returned - this is to keep the response more compact.
- The line item details will be returned when you retrieve an individual invoice, either by specifying Invoice ID or Invoice Number or by using the optional paging parameter (below).
Properties
Section titled “ Properties”Authentication
Section titled “Authentication”Authentication values used to connect to the Xero server.
Invoice id / number
Section titled “Invoice id / number”You can retrieve an individual record by specifying the InvoiceID or Number.
Invoice ids
Section titled “Invoice ids”Filter by a comma-separated list of InvoicesIDs. For faster response times we recommend using these explicit parameters instead of passing OR conditions into the Where filter.
Invoice numbers
Section titled “Invoice numbers”Filter by a comma-separated list of InvoiceNumbers. For faster response times we recommend using these explicit parameters instead of passing OR conditions into the Where filter.
Contact ids
Section titled “Contact ids”Filter by a comma-separated list of ContactIDs. For faster response times we recommend using these explicit parameters instead of passing OR conditions into the Where filter.
Statuses
Section titled “Statuses”Filter by a comma-separated list of Statuses. For faster response times we recommend using these explicit parameters instead of passing OR conditions into the Where filter.
Modified after
Section titled “Modified after”A UTC timestamp (yyyy-mm-ddThh:mm:ss) . Only records created or modified since this timestamp will be returned e.g. 2009-11-12T00:00:00.
Restrict the returned items using the specified criteria. See Where filter.
e.g. page=1 – Up to 100 records will be returned in a single API call with line items shown for each record.
Order by
Section titled “Order by”Return items in a specific order. See Order by filter.
Return options
Section titled “Return options”Select how the data is to be returned.
Possible values are:
- Only the first item.
- The first item or an empty item.
- All the items one by one.
- All of the items at once.