Notes
We added a new endpoint in our research admin series, this time for award tasks. We’ve added some filters we thought would be useful, but please let us know if there’s anything you’d like that we missed!
We’ve added the ability to filter grants based on a principal investigator ID using filter[investigatorId]. You can use this to find which grants a given investigator has available for them to spend on. Note that we don’t provide any information on the current spendable amount on the grant, so you’ll want to combine this with other checks before submitting a charge, but this endpoint is a good place to start.
Hierarchies now have availability dates and inactive dates. You can use these to determine whether a cost center hierarchy is active as of a particular date you’re interested in. The availability date will always be present, but may be in the future, so check to make sure you’re not using a hierarchy that hasn’t been activated yet. The inactive date will not be present on all records. A hierarchy is active if both of the following are true:
- The availability date is today or in the past
- The inactive date is not present or in the future
We’re still working on adding cost center managers and leadership role assignees to cost centers, but we expect that’ll be available by the time of our next sprint review.
We’re also still doing some internal cleanup tasks. We removed old ETL clients that we don’t use anymore for SOAP and RaaS connections, and we’re splitting our OpenAPI specification into parts on the back end. It’ll still be combined into one big file that you can download from the developer portal, so you won’t see any change on the API user side.
API Changes
- New award tasks endpoint
- New
investigatorIdfilter for grants - New
availabilityDateandinactiveDatefields for cost center hierarchies