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

Get agreement for extension

Generic extension agreement detail placeholder. The current handler accepts any extensionId, looks up an agreement by SoftwareOne-style external ID such as agr-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 GenericExtensionAgreementDetailResponse

successbooleanRequired
Request succeeded.
Enum: true
dataobjectRequired
idstringRequired
SoftwareOne agreement identifier, such as agr-001. This is an external SoftwareOne-style ID, not an Alga UUID.
namestringRequired
Human-readable agreement name.
productstringRequired
Product or SKU name associated with the agreement.
vendorstringRequired
Software vendor name, such as Microsoft or Adobe.
consumerstringRequired
End-customer organization name for the agreement.
statusstringRequired
Agreement status.
Enum: activeinactivependingexpired
currencystringRequired
Three-letter billing currency code, such as USD.
spxynumberRequired
Annual SPx value from SoftwareOne dummy data.
marginRpxynumberRequired
Margin RPxY value from SoftwareOne dummy data.
operationsstringRequired
Operational visibility state for the agreement.
Enum: visiblehiddenrestricted
billingConfigIdstringRequired
SoftwareOne billing configuration identifier associated with the agreement.
localConfigobject
Locally editable configuration metadata. Current MVP data includes autoRenewal and notificationDays.
autoRenewalboolean
Whether local auto-renewal is enabled.
notificationDaysinteger
Days before renewal/expiry to notify.
markupnumber
Optional local markup percentage used by richer SoftwareOne schemas.
notesstring
Optional local notes.
tagsarray of string
Optional local tags.
itemsstring
startDatestring
Agreement start date in YYYY-MM-DD format.
endDatestring
Agreement end date in YYYY-MM-DD format.
billingCyclestring
Billing cycle cadence, such as monthly or annual.
paymentTermsstring
Payment terms, such as Net 30.
descriptionstring
Free-text agreement description.
contactPersonstring
Primary contact name for the agreement.
contactEmailstring <email>
Primary contact email address.
licenseCountinteger
Number of licenses covered by the agreement.
pricePerLicensenumber
Price per license in the agreement currency.
metaobjectRequired
extensionIdstringRequired
Extension ID echoed from the path.

Response codes

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