List employee advance requests

Operation ID: employeeAdvances

Group: Accounting › Employee Advances

Open in the interactive reference

GET /accounting/employee-advances

Read-only: Reads and returns; changes nothing.

Lists employee advance requests. Each item is a summary of the request, with its amount, currency, status, and request date.

For employeeName, the trip dates, notes, the decision note, and the issued payment, use GET accounting/employee-advances/:id or POST accounting/employee-advances/search.

Parameters

Name In Type Required Description
Api-Version header string · v1 yes The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version v1.

Query surface

Response

200 Success

Under data, an array of employeeAdvancesRow:

Field Type Required Filter Sort Description
id string no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) yes Stable, platform-assigned id (a UUID) of the advance request — the public identifier used by GET accounting/employee-advances/:id. Filter e.g. filter[id][in]=<id1>,<id2>.
advanceRequestNumber string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) yes System-generated document number (ADV-...). Filter target: filter[advanceRequestNumber][eq]=ADV-1042.
employeeId string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no Id (a UUID) of the requesting employee. Filter e.g. filter[employeeId][eq]=<uuid>.
entityId string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no Id (a UUID) of the entity the request belongs to.
categoryId string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no Id (a UUID) of the AdvancePaymentCategory this request draws from.
amount decimal | null no no yes Requested amount, in currency. Orderable, e.g. sort=-amount.
currency string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no ISO 4217 three-letter currency code that governs amount. Filter target: filter[currency][in]=USD,EUR.
purpose string | null no no no What the advance is for.
status string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) yes Lifecycle status: draft, pendingApproval, approved, rejected or issued. Filter target: filter[status][eq]=pendingApproval.
requestDate date | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) yes Date the request was submitted, as YYYY-MM-DD. Filter target: filter[requestDate][gte]=2026-01-01.
lastModifiedDate date-time | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) yes Instant the request last changed, as ISO 8601 UTC (YYYY-MM-DDTHH:mm:ss.sssZ). filter[lastModifiedDate][gte]=… plus sort=lastModifiedDate is a complete incremental-sync cursor. 
{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "advanceRequestNumber": "<advanceRequestNumber>",
      "employeeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "categoryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "amount": "19.99",
      "currency": "<currency>",
      "purpose": "<purpose>",
      "status": "<status>",
      "requestDate": "2026-01-15",
      "lastModifiedDate": "2026-01-15T09:30:00.000Z"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "<nextCursor>"
  }
}

Statuses