Skip to content

Award

A grant award, tracking the funder, recipient, and financial details of a grant that resulted from an opportunity. It references the source opportunity and application, and its funders and recipient organizations via OrgRef.

PropertyTypeRequiredDescription
iduuidYesGlobally unique id for the award
titlestringYesTitle or name of the award
identifiersAwdIdsNoSystem and registry-specific identifiers for the award
descriptionstringYesDescription of the award's purpose
statusAwdStatusYesLifecycle status of the award
fundingAwdFundingNoRequested, awarded, and disbursed amounts
keyDatesAwdTimelineNoAward date and period of performance
opportunityOppRefNoThe opportunity this award resulted from
applicationAppRefNoThe application this award resulted from
fundersOrgRefCollectionNoOrganization(s) that funded the award
recipientOrganizationsOrgRefCollectionNoOrganization(s) that received the award, if the recipient is an organization
recipientIndividualAwdRecipientIndividualNoThe individual who received the award, if the recipient is a person
parentAwdRefNoParent award, for amendments or multi-tranche awards
sourceurlNoURL for the canonical source record of the award
createdAtutcDateTimeYesThe timestamp (in UTC) at which the record was created.
lastModifiedAtutcDateTimeYesThe timestamp (in UTC) at which the record was last modified.

A JSON example of this model.

{
"id": "01912a8b-7c3d-7894-abcd-ef1234567890",
"title": "Community Health Center Capital Improvement Grant",
"identifiers": {
"systemId": {
"registry": {
"code": "awd:grants.gov:system"
},
"id": "01912a8b-7c3d-7894-abcd-ef1234567890"
},
"awd:us:fain": {
"registry": {
"code": "awd:us:fain",
"url": "https://commongrants.org/registries/awd-us-fain"
},
"id": "H80CS00001"
}
},
"description": "Supports facility upgrades at federally qualified health centers.",
"status": {
"value": "awarded",
"description": "Award has been issued and funds are being disbursed."
},
"funding": {
"requestedAmount": {
"amount": "500000.00",
"currency": "USD"
},
"awardedAmount": {
"amount": "450000.00",
"currency": "USD"
},
"disbursedAmount": {
"amount": "150000.00",
"currency": "USD"
}
},
"keyDates": {
"awardDate": {
"name": "Award date",
"eventType": "singleDate",
"date": "2026-03-01",
"description": "The date the award was issued."
},
"periodOfPerformance": {
"name": "Period of performance",
"eventType": "dateRange",
"startDate": "2026-04-01",
"endDate": "2027-03-31",
"description": "The period during which the funded work is performed."
}
},
"opportunity": {
"id": "018f2e77-3a4b-7c1d-9e2f-abcdef123456",
"title": "Health Center Capital Improvement Program"
},
"funders": {
"primary": {
"id": "018f2e77-4b5c-7d2e-9f3a-bcdef1234567",
"name": "Health Resources and Services Administration",
"identifiers": {
"otherIds": {
"org:grants.gov:agency": {
"registry": {
"code": "org:grants.gov:agency"
},
"id": "HRSA"
}
}
}
}
},
"recipientOrganizations": {
"primary": {
"id": "018f2e77-6d7e-7f4a-9b5c-def123456789",
"name": "Riverside Community Health Center",
"identifiers": {
"org:us:ein": {
"registry": {
"code": "org:us:ein"
},
"id": "123456789"
}
}
}
},
"source": "https://www.usaspending.gov/award/ASST_NON_H80CS00001",
"createdAt": "2026-03-01T00:00:00Z",
"lastModifiedAt": "2026-06-01T00:00:00Z"
}
VersionChangesSchema
0.4.0
  • Added AwardBase model
AwardBase.yaml

A reference to an award, previewing the key fields a consumer needs to identify it and look it up or join it to another response. Appears wherever another record points to an award, such as a parent award for an amendment or tranche.

PropertyTypeRequiredDescription
iduuidYesGlobally unique id for the award
titlestringYesTitle or name of the award
identifiersAwdIdsNoSystem and registry-specific identifiers for the award

A JSON example of this model.

{
"id": "01912a8b-7c3d-7894-abcd-ef1234567890",
"title": "Community Health Center Capital Improvement Grant",
"identifiers": {
"systemId": {
"registry": {
"code": "awd:grants.gov:system"
},
"id": "01912a8b-7c3d-7894-abcd-ef1234567890"
},
"awd:us:fain": {
"registry": {
"code": "awd:us:fain",
"url": "https://commongrants.org/registries/awd-us-fain"
},
"id": "H80CS00001"
}
}
}
VersionChangesSchema
0.4.0
  • Added AwdRef model
AwdRef.yaml

The lifecycle status of an award, such as whether it has been awarded or completed.

PropertyTypeRequiredDescription
valueAwdStatusOptionsYesThe status of the award, from a predefined set of options
customValuestringNoA custom value for the status
descriptionstringNoA human-readable description of the status

A JSON example of this model.

{
"value": "awarded",
"description": "Award has been issued and funds are being disbursed."
}
VersionChangesSchema
0.4.0
  • Added AwdStatus model
AwdStatus.yaml

The set of values accepted for award status.

ValueDescription
awardedThe award has been issued and funds are being disbursed
completedThe award's period of performance has ended
cancelledThe award was cancelled or terminated
customA custom status

A JSON example of this model.

"awarded"
VersionChangesSchema
0.4.0
  • Added AwdStatusOptions enum
AwdStatusOptions.yaml

Financial details about the award, including the requested, awarded, and disbursed amounts.

PropertyTypeRequiredDescription
detailsstringNoDetails about the award's funding that don't fit other fields
requestedAmountMoneyNoAmount of funding requested by the recipient
awardedAmountMoneyNoAmount of funding awarded to the recipient
disbursedAmountMoneyNoAmount of funding disbursed to the recipient so far

A JSON example of this model.

{
"requestedAmount": {
"amount": "500000.00",
"currency": "USD"
},
"awardedAmount": {
"amount": "450000.00",
"currency": "USD"
},
"disbursedAmount": {
"amount": "150000.00",
"currency": "USD"
}
}
VersionChangesSchema
0.4.0
  • Added AwdFunding model
AwdFunding.yaml

Key dates in the award’s timeline, such as the award date and period of performance.

PropertyTypeRequiredDescription
awardDateEventNoThe date (and time) on which the award was issued
periodOfPerformanceEventNoThe period during which the funded work is expected to be performed
otherDatesrecord<Event>NoAn optional map of other key dates or events in the award timeline Examples might include a reporting deadline, close-out date, etc.

A JSON example of this model.

{
"awardDate": {
"name": "Award date",
"eventType": "singleDate",
"date": "2026-03-01",
"description": "The date the award was issued."
},
"periodOfPerformance": {
"name": "Period of performance",
"eventType": "dateRange",
"startDate": "2026-04-01",
"endDate": "2027-03-31",
"description": "The period during which the funded work is performed."
}
}
VersionChangesSchema
0.4.0
  • Added AwdTimeline model
AwdTimeline.yaml

An individual who received an award, when the recipient is a person rather than an organization.

PropertyTypeRequiredDescription
nameNameNoThe individual's name.
identifiersIdentifierCollectionNoIdentifiers associated with the individual, keyed by registry code.
customFieldsrecord<CustomField>NoCustom fields about the individual recipient.

A JSON example of this model.

{
"name": {
"prefix": "Dr.",
"firstName": "Jane",
"middleName": "Edward",
"lastName": "Doe",
"suffix": "Jr."
},
"identifiers": {
"systemId": {
"registry": {
"code": "org:grants.gov:system",
"url": "https://commongrants.org/registries/org-grants-gov-system"
},
"id": "01912a8b-7c3d-7890-abcd-ef1234567890"
},
"otherIds": {
"org:candid:bridge": {
"registry": {
"code": "org:candid:bridge"
},
"id": "1234567"
}
}
},
"customFields": {}
}
VersionChangesSchema
0.4.0
  • Added AwdRecipientIndividual model
AwdRecipientIndividual.yaml

System and registry-specific identifiers for an award, such as its FAIN.

PropertyTypeRequiredDescription
systemIdSystemIdNoThe hosting system's own identifier for this record.
otherIdsrecord<Identifier>NoAdditional identifiers keyed by their registry code, for registries the protocol does not define as a base identifier on the model.
awd:us:fainAwdIdFainNoThe award's Federal Award Identification Number (FAIN).

A JSON example of this model.

{
"systemId": {
"registry": {
"code": "awd:grants.gov:system"
},
"id": "01912a8b-7c3d-7894-abcd-ef1234567890"
},
"awd:us:fain": {
"registry": {
"code": "awd:us:fain",
"url": "https://commongrants.org/registries/awd-us-fain"
},
"id": "H80CS00001"
}
}
VersionChangesSchema
0.4.0
  • Added AwdIds model
AwdIds.yaml

An award’s Federal Award Identification Number (FAIN), assigned by the awarding agency. It pins registry.code to awd:us:fain.

PropertyTypeRequiredDescription
registryrecordNoRegistry-level facts shared by every record in this registry.
idstringNoThe primary identifier string, when the registry has a single canonical value. May be omitted for registries with no natural primary; consumers should read `allIds` in that case.
allIdsarray<object>NoEvery known identifier for this record in this registry, including archived values.

A JSON example of this model.

{
"registry": {
"code": "awd:us:fain",
"url": "https://commongrants.org/registries/awd-us-fain"
},
"id": "H80CS00001"
}
VersionChangesSchema
0.4.0
  • Added AwdIdFain model
AwdIdFain.yaml