The ACC Cost team has released a small but meaningful update to improve the completeness, usability, and flexibility of the Cost API. These updates introduce additional contract lifecycle tracking fields, enhanced budget code visibility, and expanded editing capabilities for expenses.
This update is fully backward-compatible, but developers may want to adopt the new fields to improve data workflows.
What’s New
1. New Contract Lifecycle Date/Time Fields
To provide more granular visibility into contract progress, 11 new timestamp fields have been added across the following endpoints:
-
GET /contracts
-
POST /contracts
-
GET /contracts/:id
-
PATCH /contracts/:id
These new fields allow applications to track key events across the lifecycle of a contract:
-
awardedAt -
statusChangedAt -
sentAt -
respondedAt -
responseDue -
returnedAt -
onsiteAt -
offsiteAt -
procuredAt -
approvedAt -
executedAt
These timestamps can be used to power more accurate reporting, auditing, dashboards, and workflow automation.
2. New Budget Code Fields on Payment Items
Two budget code fields have been added to the GET /payment-items endpoint:
-
budgetCode– Raw, unformatted budget code -
budgetFormattedCode– Formatted code with separators for improved readability
This enhancement helps consumers display consistent, human-friendly budget codes in UI applications while still supporting system-friendly code handling.
3. Editable mainContractId for Expenses
The PATCH /expenses/:id endpoint now allows editing the mainContractId field.
This enables developers to:
-
Reassign expenses to a different main contract
-
Correct data entry mistakes
-
Build workflows that adjust contract structures over time
This improves flexibility when maintaining cost structures throughout the project lifecycle.
No Breaking Changes
This release does not change existing contract or cost behaviors. All additions are optional and backward-compatible.
More Information
Developers integrating with ACC Cost should review the updated API reference for field definitions and payload examples.
If you have feedback or questions about these updates, please feel free to contact APS support.