API reference›Open items›Retrieve Open Item Aging
104 operations ↓ OpenAPI JSON Get API key
GET /v1/open-items/aging

Retrieve Open Item Aging

Retrieve canonical AR/AP aging buckets from posted invoices, allocations, supplier payables, and supplier-payable settlements.

Requires API key OpenAPI v1

Authentication

Use a HelvCore API key in the Authorization header. Keys are server-side secrets and must not be exposed to browser JavaScript.

GETHeader
Authorization: Bearer hc_...

Parameters

kindenum<receivable | payable>requiredquery

Documented field.

end_customer_idstringrequiredquery

Documented field.

as_ofstringrequiredquery

Documented field.

currencyenum<CHF | EUR>optionalquery

Documented field.

legal_entity_idstringoptionalquery

Documented field.

Returns

Returns a documented JSON response on success and the standard HelvCore error envelope on failure.

200Successful response.
defaultStructured error response.
401invalid_auth - missing, expired, or invalid Bearer key

Stable error codes

api_key_disabledDocumented HelvCore error code for this operation.
api_key_expiredDocumented HelvCore error code for this operation.
invalid_authDocumented HelvCore error code for this operation.
invalid_requestDocumented HelvCore error code for this operation.
validation_failedDocumented HelvCore error code for this operation.