List Cost Entry Source Lines
GET/api/cost-entries/:costEntry/source-lines
Paginated source lines of one cost entry: one row per charge on the vendor document the entry was booked from, each with how much of it is allocated (through allocations linked to the line) and the basis of its amount. Lines that are not fully allocated explain the entry's unallocated amount.
purchase-orders:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Filters (all optional, also usable inside filter_groups):
filter[search]— reference / SKU, description, charge, product SKU or name, and (exact, numeric) the line ID. Narrow withsearch_columns.filter[allocation_state.is]/.is_not— allocated, partial, unallocated, not_allocated (partial + unallocated: every line that explains Unallocated).filter[charge_type.is]— product_charge, account_fee, unmatched_reference, rounding, adjustment, other.filter[basis.is]— invoiced, estimated_split, computed, manual.filter[charge_group.is],filter[external_reference.contains],filter[description.contains],filter[product_id.is],filter[line_number.*],filter[amount.*],filter[unallocated_amount.greater_than].
Allowed sorts (prefix - for descending): id, line_number, charge_group, charge_type, external_reference, amount, basis, unallocated_amount, allocation_state. Default: line_number.
Response adds unfiltered_total (all lines on the entry).
Authentication: Requires Bearer token (scope purchase-orders:read).
Request
Responses
- 200
- 401
- 403
- 404
- 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.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
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.