Finance APIs

Awards

View the OpenAPI specification

Awards are a record of money being allocated to one or more grants. Each award can have one or more award lines, and each award line has exactly one grant.

An award always has one central accountant (identified by the centralAwardAccountantId and centralAwardAccountantName attributes) and one principal investigator (identified by the piId and piName attributes). If an award includes co-investigators, their names and IDs will be listed under coInvestigators or PrinciaplInvestigators.

Filters

Awards can be filtered by:

Details & definitions

  • A sponsor is the entity the UW directly interacts with for the award, such as when sending invoices.
  • A prime sponsor is the entity providing funding to the sponsor. Often this is the same as the sponsor, but for example if NSF gave an award to a different university, and that university subawarded part of it to UW, that university would be the sponsor and NSF would be the prime sponsor.
  • The award date indicates when the award was created in Workday. For new awards after July 2025, this will be the same as the issue date in RAMP. For older awards, it’s the date they were imported from RAMP into Workday.
  • The authorized amount is the amount that the sponsor has authorized UW to spend at this time. This does not include cost share, if present.
  • The total amount is the authorized amount plus cost share.

Example repsonse element

{
    "attributes": {
        "anticipatedFacilitiesAdminAmount": 0,
        "anticipatedSponsorDirectCostAmount": 0,
        "anticipatedSponsorTotalAmount": 0,
        "assistanceListingDescription": "Great Lakes Restoration",
        "assistanceListingNumber": "15.662",
        "authorizedAmount": 148000,
        "awardTotalAmount": 148000,
        "awardType": "Grant",
        "billToSponsor": "DUCKS UNLIMITED",
        "billToSponsorId": "SPN001475",
        "billedToDateAmount": 148000,
        "billingLimitOverride": 0,
        "centralAwardAccountantid": "00331909",
        "centralAwardAccountantname": "Jeffrey J Selner",
        "coInvestigators": [
            {
                "id": "00123456",
                "name": "Bucky Badger"
            }
        ],
        "coPrincipalInvestigators": [
        ],
        "company": "UWGBY",
        "costCenter": "CC000181",
        "costShareRequiredBySponsor": 1,
        "costShareTotalAmount": 0,
        "currency": "USD",
        "date": "2020-01-01 08:00:00",
        "defaultPaymentType": "Incoming ACH",
        "description": "Green Bay Priority Wetland Inv",
        "enteredLineAmount": 148000,
        "federalAwardId": "US-WI-429-1",
        "fund": "FD0144",
        "institutionalId": "UWGBY_AAH5481",
        "isSubAward": true,
        "letterOfCreditDocumentId": "",
        "letterOfCreditId": "",
        "lifecycleStatus": "Open",
        "name": "Green Bay Priority Wetland Inv",
        "paymentTerms": "Net 30",
        "primeSponsorId": "UWMSN_MSN101063",
        "primeSponsorName": "INTERIOR, US FISH & WILDLIFE SERVICE",
        "piId": "00837811",
        "piName": "Amy L Carrozzino-Lyon",
        "purposeCode": "Research",
        "scheduleEndDate": "2023-12-31 00:00:00",
        "scheduleStartDate": "2020-01-01 00:00:00",
        "signedDate": "",
        "sponsor": "DUCKS UNLIMITED",
        "sponsorAwardReferenceNumber": "US-WI-429-1",
        "sponsorDirectCostAmount": 130670,
        "sponsorFacilitiesAdminAmount": 0,
        "sponsorId": "SPN001475",
        "sponsorTotalAmount": 148000,
        "status": "Approved",
        "versionNumber": "0",
        "versionStatus": "Award In Effect"
    },
    "id": "AWD-000078",
    "links": {
        "self": "https://api.wisc.edu/finance/awards/AWD-000078"
    },
    "type": "awards"
}