List Entries by Source
GET/api/ledger/entries/by-source-list
Every live (non-discarded, non-reversal, non-reversed) v2 ledger journal entry for a source document, as a lightweight list. Where /by-source returns only the latest single entry, a source can post more than one current entry — an Amazon settlement posts both an invoice AND a bill; a vendor credit posts the credit entry plus one applied entry per allocation — so a source document's accounting list needs the full set. Each item links to /v2/ledger/entries/{id}. source_type is the source model FQN.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Returns data: an array of { id, type, type_label, status, reference, effective_at, total, display_status }. Empty array when the source has no live entries.
total is the NET document total (the provider-booked face value — net control-account movement), not the gross debit total. For an Amazon settlement bill with internal reserve contra legs the two differ (e.g. 842.67 net vs 1,305.86 gross).
status is the entry's lifecycle status (draft / posted / reversed). display_status is the composite sync status ({ key, label, color }); its fields are null when the entry does not participate in provider sync.
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.