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.
| 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" }, "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"}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 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:00Zdescription: A grant awardThe TypeSpec code for this model.
/** 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 supports * customization by extending the `customFields` property. */@doc("A grant award")@example(Examples.Award.awardBase)@Versioning.added(CommonGrants.Versions.v0_4)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;}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.
| 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.
/** 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. */@example(Examples.Award.ref)@Versioning.added(CommonGrants.Versions.v0_4)model AwdRef { /** Globally unique id for the award */ @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;}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 status of the award, from a predefined set of options |
| customValue | string | No | A custom value for the status |
| description | string | No | A human-readable description of the status |
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 status of the award, from a predefined set of options customValue: type: string description: A custom value for the status description: type: string description: A human-readable description of the statusrequired: - 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 { /** The status of the award, from a predefined set of options */ value: AwdStatusOptions;
/** A custom value for the status */ customValue?: string;
/** A human-readable description of the status */ description?: string;}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.
/** Financial details about the award, including the amounts requested, awarded, and disbursed */@example(Examples.Award.funding)@Versioning.added(CommonGrants.Versions.v0_4)model AwdFunding { /** Details about the award's funding that don't fit other fields */ details?: string;
/** Amount of funding requested by the recipient */ requestedAmount?: Money;
/** Amount of funding awarded to the recipient */ awardedAmount?: Money;
/** Amount of funding disbursed to the recipient so far */ disbursedAmount?: Money;}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.
/** 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 { /** The date (and time) on which the award was issued */ awardDate?: Event;
/** The period during which the funded work is expected to be performed */ periodOfPerformance?: Event;
/** 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>;}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.
/** 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. */ name?: Name;
/** Identifiers associated with the individual, keyed by registry code. */ identifiers?: IdentifierCollection;
/** Custom fields about the individual recipient. */ customFields?: Record<CustomField>;}Changelog
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.
/** 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`. */@example(Examples.Award.identifiers)@Versioning.added(CommonGrants.Versions.v0_4)model AwdIds extends Fields.IdentifierCollection { /** The award's Federal Award Identification Number (FAIN). */ `awd:us:fain`?: AwdIdFain;}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.
/** 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 |
| AwdIdFain.yaml |