Skip to main content
GET
/
api
/
organization
/
{organization_uid}
/
ap-invoices
List AP invoices
curl --request GET \
  --url https://dev.exante.app/api/organization/{organization_uid}/ap-invoices \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    "<unknown>"
  ],
  "_meta": {
    "page": 123,
    "per_page": 123,
    "total_pages": 123,
    "total_items": 123
  },
  "_links": {
    "self": "<string>",
    "next": "<string>",
    "prev": "<string>"
  }
}
Returns a paginated list of accounts payable invoices for one organization.

​
Role-aware access

  • Admin users can see all AP invoices.
  • Other users only see invoices assigned to them.

​
Slim list view

Pass view=list to receive a lightweight payload optimized for table rendering. The slim response returns only the fields the table needs per row: uid, status, invoice_number, issue_date, due_date, currency, has_comments, stamp_number, received_date, document_type, vendor_nit, vendor_name, amount_due, registration_number, approved_by, registered_by, approval_date, registration_date. Heavy fields like parties, integrations, invoice_notes, line_items, and comments are omitted. The modal already fetches full invoice data via the action logs endpoint on click, so the list does not need to carry that weight. When view is omitted, the full response shape is returned (unchanged for backwards compatibility).

​
Useful filters

  • status for workflow state filtering.
  • vendor_name, vendor_nit, invoice_number, and stamp_number for field-specific searches.
  • keyword for broad text search.
  • include_comments=true to include invoice comments on each item (ignored when view=list).
  • approved_by and registered_by to filter by the user who approved or registered the invoice.
  • approval_date_from / approval_date_to and registration_date_from / registration_date_to for date-range filters on when the invoice was approved or registered.
  • responsible to filter by the user responsible for the next action.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
organization_uid
string<uuid>
required

Organization UID

Query Parameters

​
page
integer
default:1
Required range: x >= 1
​
per_page
integer
default:25
Required range: 1 <= x <= 100
​
view
enum<string>

Response view mode. list returns a slim payload with only the fields the table renders (skips parties, integrations, invoice_notes, line_items, and comments). When omitted the full response shape is returned.

Available options:
list
​
sort_by
string
default:issue_date

Sort field: due_date, issue_date, status, invoice_number, document_type, stamp_number, vendor_name, vendor_nit, received_date, amount_due, approved_by, approval_date, registered_by, registration_date, registration_number, has_comments.

​
sort_order
enum<string>
default:desc
Available options:
asc,
desc
​
status
string

Comma-separated AP invoice statuses.

​
due_date_from
string<date-time>
​
due_date_to
string<date-time>
​
due_date
string<date-time>
​
issue_date_from
string<date-time>
​
issue_date_to
string<date-time>
​
issue_date
string<date-time>
​
received_date_from
string<date-time>
​
received_date_to
string<date-time>
​
received_date
string<date-time>
​
document_type
string
​
invoice_number
string
​
stamp_number
string
​
vendor_nit
string
​
vendor_name
string
​
include_comments
boolean
default:false

Include comment objects on each invoice item.

​
has_comments
boolean

Filter by whether invoices have comments.

​
keyword
string

Keyword search across AP invoice fields.

​
approval_date_from
string<date-time>

Filter invoices approved on or after this date (ISO format).

​
approval_date_to
string<date-time>

Filter invoices approved on or before this date (ISO format).

​
registration_date_from
string<date-time>

Filter invoices registered on or after this date (ISO format).

​
registration_date_to
string<date-time>

Filter invoices registered on or before this date (ISO format).

​
approved_by
string

Filter by the user ID who approved the invoice.

​
registered_by
string

Filter by the user ID who registered the invoice.

​
responsible
string

Filter by the user ID responsible for the next action on the invoice.

Response

Paginated AP invoice list. Shape depends on the view parameter: when view=list returns APInvoiceListViewResponse (slim), otherwise returns APInvoiceListResponse (full).

​
items
any[]
​
_meta
object
​
_links
object