Award
AwardBase
Section titled “AwardBase”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. Since v0.5 that opportunity link is also published in the other direction: an opportunity’s detail record can list the awards it produced under OpportunityDetails.awards. Since v0.5 the routes that serve this model are optional rather than experimental, so an implementation may omit them, but a breaking change to them now requires incrementing the Major protocol version; see Award routes.
| Property | Type | Required | Description |
|---|---|---|---|
| id | uuid | Yes | Globally unique id for the award |
| title | string | Yes | Title or name of the award |
| identifiers | AwdIds | No | System and registry-specific identifiers for the award |
| description | string | Yes | Description of the award's purpose |
| status | AwdStatus | Yes | Lifecycle status of the award |
| funding | AwdFunding | No | Requested, awarded, and disbursed amounts |
| keyDates | AwdTimeline | No | Award date and period of performance |
| opportunity | OppRef | No | The opportunity this award resulted from |
| application | AppRef | No | The application this award resulted from |
| funders | OrgRefCollection | No | Organization(s) that funded the award |
| recipientOrganizations | OrgRefCollection | No | Organization(s) that received the award, if the recipient is an organization |
| recipientIndividual | AwdRecipientIndividual | No | The individual who received the award, if the recipient is a person |
| parent | AwdRef | No | Parent award, for amendments or multi-tranche awards |
| source | url | No | URL for the canonical source record of the award |
| createdAt | utcDateTime | Yes | The timestamp (in UTC) at which the record was created. |
| lastModifiedAt | utcDateTime | Yes | The timestamp (in UTC) at which the record was last modified. |
Formats
Section titled “Formats”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", "identifiers": { "opp:us:fon": { "registry": { "code": "opp:us:fon", "url": "https://commongrants.org/registries/opp-us-fon" }, "id": "HHS-2026-ACF-OCC-YD-0001" } } }, "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": "582345679" } } } }, "source": "https://www.usaspending.gov/award/ASST_NON_H80CS00001", "createdAt": "2026-03-01T00:00:00Z", "lastModifiedAt": "2026-06-01T00:00:00Z"}The JSON Schema for this model.
$schema: https://json-schema.org/draft/2020-12/schema$id: AwardBase.yamltype: objectproperties: id: $ref: uuid.yaml description: Globally unique id for the award title: type: string examples: - Community Health Center Capital Improvement Grant description: Title or name of the award identifiers: $ref: AwdIds.yaml description: System and registry-specific identifiers for the award description: type: string examples: - Supports facility upgrades at federally qualified health centers. description: Description of the award's purpose status: $ref: AwdStatus.yaml description: Lifecycle status of the award funding: $ref: AwdFunding.yaml description: Requested, awarded, and disbursed amounts keyDates: $ref: AwdTimeline.yaml description: Award date and period of performance opportunity: $ref: OppRef.yaml description: The opportunity this award resulted from application: $ref: AppRef.yaml description: The application this award resulted from funders: $ref: OrgRefCollection.yaml description: Organization(s) that funded the award recipientOrganizations: $ref: OrgRefCollection.yaml description: Organization(s) that received the award, if the recipient is an organization recipientIndividual: $ref: AwdRecipientIndividual.yaml description: The individual who received the award, if the recipient is a person parent: $ref: AwdRef.yaml description: Parent award, for amendments or multi-tranche awards source: type: string format: uri description: URL for the canonical source record of the award createdAt: type: string format: date-time description: The timestamp (in UTC) at which the record was created. lastModifiedAt: type: string format: date-time description: The timestamp (in UTC) at which the record was last modified.required: - id - title - description - status - createdAt - lastModifiedAtunevaluatedProperties: not: {}examples: - 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 identifiers: opp:us:fon: registry: code: opp:us:fon url: https://commongrants.org/registries/opp-us-fon id: HHS-2026-ACF-OCC-YD-0001 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: "582345679" source: https://www.usaspending.gov/award/ASST_NON_H80CS00001 createdAt: 2026-03-01T00:00:00Z lastModifiedAt: 2026-06-01T00:00:00Zdescription: A grant awardThe TypeSpec code for this model.
model AwardBase { // Identity fields shared with AwdRef ...AwdRef;
/** Description of the award's purpose */ @example("Supports facility upgrades at federally qualified health centers.") description: string;
/** Lifecycle status of the award */ status: AwdStatus;
/** Requested, awarded, and disbursed amounts */ funding?: AwdFunding;
/** Award date and period of performance */ keyDates?: AwdTimeline;
/** The opportunity this award resulted from */ opportunity?: OppRef;
/** The application this award resulted from */ application?: AppRef;
/** Organization(s) that funded the award */ funders?: OrgRefCollection;
/** Organization(s) that received the award, if the recipient is an organization */ recipientOrganizations?: OrgRefCollection;
/** The individual who received the award, if the recipient is a person */ recipientIndividual?: AwdRecipientIndividual;
/** Parent award, for amendments or multi-tranche awards */ parent?: AwdRef;
/** URL for the canonical source record of the award */ source?: url;
// Spreads the fields from the SystemMetadata model into the Award model ...SystemMetadata;}
// #########################################################// Search: filters// #########################################################
/** Filters to apply when searching for awards */@Versioning.added(CommonGrants.Versions.v0_4)model AwdFilters { /** The default filters to apply to the search */Changelog
Section titled “Changelog”| Version | Changes | Schema |
|---|---|---|
| 0.4.0 |
| AwardBase.yaml |
AwdRef
Section titled “AwdRef”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, or, since v0.5, the awards an opportunity produced on OpportunityDetails.
| Property | Type | Required | Description |
|---|---|---|---|
| id | uuid | Yes | Globally unique id for the award |
| title | string | Yes | Title or name of the award |
| identifiers | AwdIds | No | System and registry-specific identifiers for the award |
Formats
Section titled “Formats”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" } }}The JSON Schema for this model.
$schema: https://json-schema.org/draft/2020-12/schema$id: AwdRef.yamltype: objectproperties: id: $ref: uuid.yaml description: Globally unique id for the award title: type: string examples: - Community Health Center Capital Improvement Grant description: Title or name of the award identifiers: $ref: AwdIds.yaml description: System and registry-specific identifiers for the awardrequired: - id - titleunevaluatedProperties: not: {}examples: - 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: H80CS00001description: |- 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.The TypeSpec code for this model.
@visibility(Lifecycle.Read) id: uuid;
/** Title or name of the award */ @example("Community Health Center Capital Improvement Grant") title: string;
/** System and registry-specific identifiers for the award */ identifiers?: AwdIds;}
// #########################################################// Award recipient// #########################################################
/** An individual who received an award, when the recipient is a person rather than an organization. */@Versioning.added(CommonGrants.Versions.v0_4)model AwdRecipientIndividual { /** The individual's name. */Changelog
Section titled “Changelog”| Version | Changes | Schema |
|---|---|---|
| 0.4.0 |
| AwdRef.yaml |
AwdStatus
Section titled “AwdStatus”The lifecycle status of an award, such as whether it has been awarded or completed.
| Property | Type | Required | Description |
|---|---|---|---|
| value | AwdStatusOptions | Yes | The selected value, from a predefined set of options |
| customValue | string | No | A custom value, used when the selected value is the `custom` option |
| description | string | No | A human-readable description of the value |
Formats
Section titled “Formats”A JSON example of this model.
{ "value": "awarded", "description": "Award has been issued and funds are being disbursed."}The JSON Schema for this model.
$schema: https://json-schema.org/draft/2020-12/schema$id: AwdStatus.yamltype: objectproperties: value: $ref: AwdStatusOptions.yaml description: The selected value, from a predefined set of options customValue: type: string description: A custom value, used when the selected value is the `custom` option description: type: string description: A human-readable description of the valuerequired: - valueunevaluatedProperties: not: {}examples: - value: awarded description: Award has been issued and funds are being disbursed. - value: custom customValue: suspended description: Disbursements are paused pending a compliance review.description: The status of the awardThe TypeSpec code for this model.
/** The status of the award */@example(Examples.Award.customStatus)@example(Examples.Award.status)@Versioning.added(CommonGrants.Versions.v0_4)model AwdStatus is Fields.ExtensibleEnumT<AwdStatusOptions>;
// #########################################################// AwdFunding// #########################################################
/** Financial details about the award, including the amounts requested, awarded, and disbursed */@example(Examples.Award.funding)@Versioning.added(CommonGrants.Versions.v0_4)model AwdFunding {Changelog
Section titled “Changelog”| Version | Changes | Schema |
|---|---|---|
| 0.4.0 |
| AwdStatus.yaml |
AwdStatusOptions
Section titled “AwdStatusOptions”The set of values accepted for award status.
| Value | Description |
|---|---|
| awarded | The award has been issued and funds are being disbursed |
| completed | The award's period of performance has ended |
| cancelled | The award was cancelled or terminated |
| custom | A custom status |
Formats
Section titled “Formats”A JSON example of this model.
"awarded"The JSON Schema for this model.
$schema: https://json-schema.org/draft/2020-12/schema$id: AwdStatusOptions.yamltype: stringenum: - awarded - completed - cancelled - customdescription: |- The set of values accepted for award status: - `awarded`: The award has been issued and funds are being disbursed - `completed`: The award's period of performance has ended - `cancelled`: The award was cancelled or terminated - `custom`: A custom statusThe TypeSpec code for this model.
/** The set of values accepted for award status: * - `awarded`: The award has been issued and funds are being disbursed * - `completed`: The award's period of performance has ended * - `cancelled`: The award was cancelled or terminated * - `custom`: A custom status */@Versioning.added(CommonGrants.Versions.v0_4)enum AwdStatusOptions { awarded, completed, cancelled, custom,}Changelog
Section titled “Changelog”| Version | Changes | Schema |
|---|---|---|
| 0.4.0 |
| AwdStatusOptions.yaml |
AwdFunding
Section titled “AwdFunding”Financial details about the award, including the requested, awarded, and disbursed amounts.
| Property | Type | Required | Description |
|---|---|---|---|
| details | string | No | Details about the award's funding that don't fit other fields |
| requestedAmount | Money | No | Amount of funding requested by the recipient |
| awardedAmount | Money | No | Amount of funding awarded to the recipient |
| disbursedAmount | Money | No | Amount of funding disbursed to the recipient so far |
Formats
Section titled “Formats”A JSON example of this model.
{ "requestedAmount": { "amount": "500000.00", "currency": "USD" }, "awardedAmount": { "amount": "450000.00", "currency": "USD" }, "disbursedAmount": { "amount": "150000.00", "currency": "USD" }}The JSON Schema for this model.
$schema: https://json-schema.org/draft/2020-12/schema$id: AwdFunding.yamltype: objectproperties: details: type: string description: Details about the award's funding that don't fit other fields requestedAmount: $ref: Money.yaml description: Amount of funding requested by the recipient awardedAmount: $ref: Money.yaml description: Amount of funding awarded to the recipient disbursedAmount: $ref: Money.yaml description: Amount of funding disbursed to the recipient so farunevaluatedProperties: not: {}examples: - requestedAmount: amount: "500000.00" currency: USD awardedAmount: amount: "450000.00" currency: USD disbursedAmount: amount: "150000.00" currency: USDdescription: Financial details about the award, including the amounts requested, awarded, and disbursedThe TypeSpec code for this model.
/** Amount of funding awarded to the recipient */ awardedAmount?: Money;
/** Amount of funding disbursed to the recipient so far */ disbursedAmount?: Money;}
// #########################################################// AwdTimeline// #########################################################
/** Key dates in the award's timeline, such as the award date and period of performance */@example(Examples.Award.timeline)@Versioning.added(CommonGrants.Versions.v0_4)model AwdTimeline {Changelog
Section titled “Changelog”| Version | Changes | Schema |
|---|---|---|
| 0.4.0 |
| AwdFunding.yaml |
AwdTimeline
Section titled “AwdTimeline”Key dates in the award’s timeline, such as the award date and period of performance.
| Property | Type | Required | Description |
|---|---|---|---|
| awardDate | Event | No | The date (and time) on which the award was issued |
| periodOfPerformance | Event | No | The period during which the funded work is expected to be performed |
| otherDates | record<Event> | No | An optional map of other key dates or events in the award timeline Examples might include a reporting deadline, close-out date, etc. |
Formats
Section titled “Formats”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." }}The JSON Schema for this model.
$schema: https://json-schema.org/draft/2020-12/schema$id: AwdTimeline.yamltype: objectproperties: awardDate: $ref: Event.yaml description: The date (and time) on which the award was issued periodOfPerformance: $ref: Event.yaml description: The period during which the funded work is expected to be performed otherDates: $ref: "#/$defs/RecordEvent" description: |- An optional map of other key dates or events in the award timeline
Examples might include a reporting deadline, close-out date, etc.unevaluatedProperties: not: {}examples: - 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.description: Key dates in the award's timeline, such as the award date and period of performance$defs: RecordEvent: type: object properties: {} unevaluatedProperties: $ref: Event.yamlThe TypeSpec code for this model.
/** An optional map of other key dates or events in the award timeline * * Examples might include a reporting deadline, close-out date, etc. */ otherDates?: Record<Event>;}
// #########################################################// Award identifiers// #########################################################
/** An award's Federal Award Identification Number (FAIN), assigned by the awarding agency. */@example(Examples.Award.fain)@Versioning.added(CommonGrants.Versions.v0_4)model AwdIdFain is Fields.IdentifierT<string, "awd:us:fain">;Changelog
Section titled “Changelog”| Version | Changes | Schema |
|---|---|---|
| 0.4.0 |
| AwdTimeline.yaml |
AwdRecipientIndividual
Section titled “AwdRecipientIndividual”An individual who received an award, when the recipient is a person rather than an organization.
| Property | Type | Required | Description |
|---|---|---|---|
| name | Name | No | The individual's name. |
| identifiers | IdentifierCollection | No | Identifiers associated with the individual, keyed by registry code. |
| customFields | record<CustomField> | No | Custom fields about the individual recipient. |
Formats
Section titled “Formats”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": {}}The JSON Schema for this model.
$schema: https://json-schema.org/draft/2020-12/schema$id: AwdRecipientIndividual.yamltype: objectproperties: name: $ref: Name.yaml description: The individual's name. identifiers: $ref: IdentifierCollection.yaml description: Identifiers associated with the individual, keyed by registry code. customFields: $ref: "#/$defs/RecordCustomField" description: Custom fields about the individual recipient.unevaluatedProperties: not: {}description: An individual who received an award, when the recipient is a person rather than an organization.$defs: RecordCustomField: type: object properties: {} unevaluatedProperties: $ref: CustomField.yamlThe TypeSpec code for this model.
/** Custom fields about the individual recipient. */ customFields?: Record<CustomField>;}
// #########################################################// AwardBase// #########################################################
/** The base model for a grant award. * * Tracks the funder, recipient, and financial details of a specific grant that * resulted from an opportunity and (optionally) an application. It supportsChangelog
Section titled “Changelog”| Version | Changes | Schema |
|---|---|---|
| 0.4.0 |
| AwdRecipientIndividual.yaml |
AwdIds
Section titled “AwdIds”System and registry-specific identifiers for an award, such as its FAIN.
| Property | Type | Required | Description |
|---|---|---|---|
| systemId | SystemId | No | The hosting system's own identifier for this record. |
| otherIds | record<Identifier> | No | Additional identifiers keyed by their registry code, for registries the protocol does not define as a base identifier on the model. |
| awd:us:fain | AwdIdFain | No | The award's Federal Award Identification Number (FAIN). |
Formats
Section titled “Formats”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" }}The JSON Schema for this model.
$schema: https://json-schema.org/draft/2020-12/schema$id: AwdIds.yamltype: objectproperties: awd:us:fain: $ref: AwdIdFain.yaml description: The award's Federal Award Identification Number (FAIN).allOf: - $ref: IdentifierCollection.yamlunevaluatedProperties: not: {}examples: - 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: H80CS00001description: |- A collection of identifiers associated with an award.
Extends the generic identifier collection with the base identifiers CommonGrants defines for awards. Additional registries can be published under `otherIds`.The TypeSpec code for this model.
`awd:us:fain`?: AwdIdFain;}
// #########################################################// AwdRef// #########################################################
/** 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.Changelog
Section titled “Changelog”| Version | Changes | Schema |
|---|---|---|
| 0.4.0 |
| AwdIds.yaml |
AwdIdFain
Section titled “AwdIdFain”An award’s Federal Award Identification Number (FAIN), assigned by the awarding agency. It pins registry.code to awd:us:fain.
| Property | Type | Required | Description |
|---|---|---|---|
| registry | record | No | Registry-level facts shared by every record in this registry. |
| id | string | No | The 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. |
| allIds | array<object> | No | Every known identifier for this record in this registry, including archived values. |
Formats
Section titled “Formats”A JSON example of this model.
{ "registry": { "code": "awd:us:fain", "url": "https://commongrants.org/registries/awd-us-fain" }, "id": "H80CS00001"}The JSON Schema for this model.
$schema: https://json-schema.org/draft/2020-12/schema$id: AwdIdFain.yamltype: objectproperties: registry: type: object properties: code: type: string const: awd:us:fain description: Canonical CommonGrants registry code, `<schema>:<scope>:<prop>` (e.g. `org:us:ein`). url: type: string format: uri description: Link to the catalog entry for this registry. unevaluatedProperties: not: {} description: Registry-level facts shared by every record in this registry. id: type: string description: |- The 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. allIds: type: array items: type: object properties: id: type: string description: The identifier string. status: $ref: IdentifierStatus.yaml description: Whether the identifier is currently valid or retired. required: - id - status unevaluatedProperties: not: {} description: Every known identifier for this record in this registry, including archived values.unevaluatedProperties: not: {}examples: - registry: code: awd:us:fain url: https://commongrants.org/registries/awd-us-fain id: H80CS00001description: An award's Federal Award Identification Number (FAIN), assigned by the awarding agency.The TypeSpec code for this model.
*/@example(Examples.Award.identifiers)@Versioning.added(CommonGrants.Versions.v0_4)model AwdIds extends Fields.IdentifierCollection {Changelog
Section titled “Changelog”| Version | Changes | Schema |
|---|---|---|
| 0.4.0 |
| AwdIdFain.yaml |