DocumentationChangelog
Documentation
Login

List invoices

get
https://public-api.spendesk.com/v2/companies//invoices

Allowed Scopes: experimental:invoice:read

Returns supplier invoices for the company, most-recent first by default, using forward-only cursor pagination. Invoice data is cached for 86400 seconds.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Company ID.

Query Params
ids
array of objects
length ≤ 50
ids
string

Filter by the supplier's invoice/credit-note number (case-insensitive exact match).

supplierId
array of strings
length ≤ 50
supplierId
buyerId
array of strings
length ≤ 50
buyerId
purchaseOrderId
array of strings
length ≤ 50
purchaseOrderId
costCenterId
array of strings
length ≤ 50
costCenterId
expenseCategoryId
array of strings
length ≤ 50
expenseCategoryId
string
enum

Kind of document the record represents.

TypeDescription
invoiceA supplier invoice: an amount the company owes the supplier for goods or services. Amounts are positive.
creditNoteA supplier credit note: a document from the same supplier that reduces an amount owed (a refund, cancellation, or correction of a prior invoice). Amounts are negative.
Allowed:
approvalStatus
array of objects

Filter by approval status; any of the listed values matches. When omitted, every listable invoice is returned (pending, approved and rejected). Draft and incomplete invoices are never listed here, not even under pending; fetch them individually by ID instead.

approvalStatus
Allowed:
paymentStatus
array of objects
paymentStatus
Allowed:
paymentSource
array of objects
paymentSource
Allowed:
paymentMethod
array of objects
paymentMethod
exportStatus
array of objects
exportStatus
Allowed:
documentaryEvidenceStatus
array of objects
documentaryEvidenceStatus
Allowed:
boolean
string
^[A-Z]{3}$

If the payment was made in a foreign currency, this amount will be the one in the payment currency. Three-letter ISO currency codes.

integer
integer
date

String containing a date expressed in ISO 8601 format like 2023-05-12.

date

String containing a date expressed in ISO 8601 format like 2023-05-12.

date

String containing a date expressed in ISO 8601 format like 2023-05-12.

date

String containing a date expressed in ISO 8601 format like 2023-05-12.

date-time

String containing a UTC datetime expressed in ISO 8601 format like 2023-05-12T14:06:40Z.

date-time

String containing a UTC datetime expressed in ISO 8601 format like 2023-05-12T14:06:40Z.

date-time

String containing a UTC datetime expressed in ISO 8601 format like 2023-05-12T14:06:40Z.

date-time

String containing a UTC datetime expressed in ISO 8601 format like 2023-05-12T14:06:40Z.

integer
1 to 100
Defaults to 20

Maximum number of invoices to return in one page.

string

Opaque pagination cursor returned as meta.pagination.nextCursor by a previous call. Omit to fetch the first page.

string
enum
Defaults to createdAt

Field to sort by. Combined with sort to set direction.

Allowed:
string
enum
Defaults to desc

Sort direction.

Allowed:
Responses

Updated 26 days ago

Did this page help you?
Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 26 days ago

Did this page help you?