Skip to main content
GET
List postings, tenant-wide

Authorizations

Authorization
string
header
required

OAuth 2.0 client_credentials grant. Send client_id:client_secret as HTTP Basic, or as form fields. Tokens are HS256 JWTs valid for one hour (configurable). Decode them at jwt.io.

Query Parameters

limit
integer
default:50
Required range: 1 <= x <= 200
cursor
string

Opaque token from a prior page's next_cursor. Do not decode or construct cursors client-side; their encoding is implementation detail and may change between releases. Cursors are stable for the resources they reference (a cursor pointing at a deleted / anonymized resource still paginates correctly. It points at a position, not at a row). No documented TTL; treat cursors as valid until the next forward-incompatible API change.

reconciled
boolean

Only reconciled (true) or only open (false). Omit for both.

account
string

Filter to one account by id.

before_value_date
string<date-time>

Only return postings with value_date < this timestamp.

Response

200 - application/json

A page of postings, oldest first

object
enum<string>
required
Available options:
list
data
object[]
required
has_more
boolean
required
livemode
boolean
required
Example:

false

request_id
string
required
Example:

"req_3LhM8XKx9q4hQv"

next_cursor
string | null
total
integer | null

Present only when the caller passed ?include_total=true.