GET
/api/public/v1/payables

List payables

What the company owes — every EXPENSE or DEDUCTION still PENDING, oldest due date first. This is a view over the ledger rather than a table of its own: a payable is simply a transaction that has not settled. Settle one by marking that transaction paid, which is what posts its journal entry and moves the tax liability.

Required scope

The access token must carry this scope. A token missing it gets 403 Forbidden. Grant them to an API client under Settings → Company → API, and to a teammate under Employee → Permissions.

payables:read

Query Parameters

NameTypeRequiredDescription
limitnumberOptionalMaximum number of items to return (1-100).Default: 20
offsetnumberOptionalNumber of items to skip before starting to collect the result set.Default: 0
sortBystringOptionalField to sort by. Allowed values vary by endpoint.Default: createdAt
sortOrderstring
asc
desc
OptionalSort direction.Default: desc
searchstringOptionalFree-text search across the resource’s primary fields.
createdAfterstringOptionalISO 8601 timestamp — only return items created after this time.
createdBeforestringOptionalISO 8601 timestamp — only return items created before this time.
updatedAfterstringOptionalISO 8601 timestamp — only return items updated after this time.
legalEntityIdstringOptionalBills owed by one entity.
dueBeforestringOptionalISO 8601. Everything due on or before this date.
GETExample request
curl
curl -X GET "https://www.pxb.app/api/public/v1/payables" \
  -H "Authorization: Bearer your_access_token"
200Example response
json
{
  "message": "Payables retrieved successfully!",
  "content": {
    "payables": [
      {
        "id": "txn_4410",
        "type": "EXPENSE",
        "status": "PENDING",
        "amount": -48000,
        "description": "Q3 hosting",
        "counterpartyName": "Cloud Co",
        "irsCategory": "Utilities",
        "date": "2026-08-01T00:00:00.000Z",
        "dueDate": "2026-09-01T00:00:00.000Z",
        "legalEntityId": "le_7788",
        "createdAt": "2026-08-01T09:00:00.000Z",
        "updatedAt": "2026-08-01T09:00:00.000Z"
      }
    ],
    "pagination": {
      "total": 42,
      "limit": 20,
      "offset": 0,
      "hasMore": true
    }
  }
}

In the console

The same thing done by hand, for anyone comparing the API against the screen they already use.

Finances → Payables
/finances/payables