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

Get statement for extension

Generic extension statement detail placeholder. The current handler accepts any extensionId, looks up a statement by SoftwareOne-style external ID such as stmt-001, and returns hardcoded detail data with meta.extensionId echoed from the path. The id path parameter is not an Alga UUID.

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 GenericExtensionStatementDetailResponse

successbooleanRequired
Request succeeded.
Enum: true
dataobjectRequired
idstringRequired
SoftwareOne statement identifier, such as stmt-001. This is an external SoftwareOne-style ID, not an Alga UUID.
statementNumberstringRequired
Human-readable statement number, such as STMT-2024-001.
periodstringRequired
Billing period in YYYY-MM format.
consumerstringRequired
End-customer organization name.
consumerIdstringRequired
SoftwareOne consumer identifier.
agreementNamestringRequired
Human-readable name of the associated agreement.
agreementIdstringRequired
SoftwareOne agreement identifier associated with this statement.
totalAmountnumberRequired
Total statement amount in the billing currency.
currencystringRequired
Three-letter billing currency code, such as USD.
lineItemCountintegerRequired
Number of line-item charges on the statement.
statusstringRequired
Statement lifecycle status used by the MVP handler.
Enum: draftfinalizedimported
dueDatestringRequired
Payment due date in YYYY-MM-DD format.
createdAtstringRequired
ISO 8601 timestamp when the statement was created.
importedAtstringRequiredNullable
ISO 8601 timestamp when imported into Alga, or null if not imported.
subtotalnumber
Statement subtotal before tax. Present on detail responses.
taxAmountnumber
Statement tax amount. Present on detail responses.
descriptionstring
Statement description. Present on detail responses.
billingAddressobject
Billing address. Present on detail responses.
clientstringRequired
Billing client organization name.
streetstringRequired
Street address.
citystringRequired
City.
statestringRequired
State or province.
zipCodestringRequired
Postal or ZIP code.
countrystringRequired
Country.
metaobjectRequired
extensionIdstringRequired
Extension ID echoed from the path.

Response codes

200
Statement detail returned successfully for the requested extension placeholder.
401
API key missing at middleware before the handler executes.
404
Statement not found.
500
Unexpected failure while fetching extension statement detail.