API reference · SoftwareOne Extensions
GET/api/extensions/{extensionId}/statements/{id}/charges

List charges for extension statement

Generic extension statement charges placeholder. The current handler accepts any extensionId, returns hardcoded charge data keyed by SoftwareOne-style statement IDs such as stmt-001, and echoes extensionId in response metadata. Unknown statement IDs return 200 with an empty data array rather than 404.

Path parameters

extensionIdstringRequired
Extension identifier from the URL. The MVP generic routes accept any value and echo it in response metadata.
idstringRequired
SoftwareOne-style external record identifier, such as agr-001 or stmt-001. This is not an Alga UUID.

Response body

Success response 200 · schema GenericExtensionChargesListResponse

successbooleanRequired
Request succeeded.
Enum: true
dataarray of SoftwareOneChargeRequired
Charge line items. Unknown statement IDs return an empty array.
itemsobject
idstringRequired
SoftwareOne charge identifier, unique within the statement, such as 1-1.
statementIdstringRequired
Parent SoftwareOne statement identifier, such as stmt-001.
descriptionstringRequired
Human-readable line item description.
productstringRequired
Product or SKU for the charge.
quantitynumberRequired
Quantity billed for this line item.
unitPricenumberRequired
Unit price in the statement currency.
totalAmountnumberRequired
Total line amount.
agreementIdstringRequired
Related SoftwareOne agreement identifier, such as agr-001.
periodstringRequired
Billing period in YYYY-MM format.
categorystringRequired
Charge category, such as Software License, Compute, Storage, or Support.
metaobjectRequired
totalintegerRequired
Number of charge records returned.
statementIdstringRequired
Statement ID from the path parameter.
extensionIdstringRequired
Extension ID echoed from the path.

Response codes

200
Charge list returned successfully. Data may be empty when the statement ID is unknown.
401
API key missing at middleware before the handler executes.
500
Unexpected failure while fetching extension statement charges.