Government awards

One award: agency, recipient, amount, date, source record.

Routes

Base URL https://api.gloom.sh. Send a key with each call; the key's account needs a plan.

GET /v1/awards

Government awards with source evidence. Reads stored data only and needs a key on an account with a plan; every plan reads every live dataset in full. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter

ticker

In

query

Type

string ^[A-Za-z0-9.:-]{1,32}$

Notes

Company symbol; normalized to uppercase.

Parameter

jurisdiction

In

query

Type

string ^[A-Za-z]{2,3}$

Parameter

currency

In

query

Type

string ^[A-Za-z]{3}$

Parameter

agency

In

query

Type

string

Parameter

sector

In

query

Type

string

Parameter

source

In

query

Type

string ^[a-z0-9_-]{1,64}$

Parameter

parentId

In

query

Type

string ^[a-f0-9]{40}$

Parameter

awardType

In

query

Type

prime, subaward, modification, notice

Parameter

from

In

query

Type

date, YYYY-MM-DD

Notes

Valid calendar date (YYYY-MM-DD). from must be on or before to.

Parameter

to

In

query

Type

date, YYYY-MM-DD

Notes

Valid calendar date (YYYY-MM-DD). from must be on or before to.

Parameter

fiscalYear

In

query

Type

integer 2000 to 2100

Parameter

query

In

query

Type

string

Parameter

minAmount

In

query

Type

string ^\d{1,24}(?:\.\d{1,6})?$

Notes

Nonnegative decimal amount, supplied as a string to preserve precision.

Parameter

cursor

In

query

Type

string

Parameter

limit

In

query

Type

integer 1 to 200

  • Credits: 4 (search x2)
  • Plans: Basic, Desk, Enterprise

GET /v1/awards/{id}

Award evidence and revisions. Reads stored data only and needs a key on an account with a plan; every plan reads every live dataset in full. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter

id

In

path, required

Type

string ^[a-f0-9]{40}$

Parameter

revisionsCursor

In

query

Type

string

  • Credits: 10 (evidence x2)
  • Plans: Basic, Desk, Enterprise

Example response

Synthetic values, marked in meta. GET /v1/datasets/awards/sample returns it with no key and no account.

json
{
  "data": {
    "generatedAt": "2026-09-30T12:00:00.000Z",
    "asOf": "2026-09-30T12:00:00.000Z",
    "status": "available",
    "access": "preview",
    "rows": [
      {
        "id": "1111111111111111111111111111111111111111",
        "revisionId": "4444444444444444444444444444444444444444",
        "source": "usaspending",
        "sourceAwardId": "ILLUSTRATIVE-1",
        "jurisdiction": "US",
        "awardType": "prime",
        "title": "Illustrative procurement 1",
        "awardDate": "2026-09-30",
        "currency": "USD",
        "obligatedAmount": "100",
        "recipient": {
          "name": "Illustrative Company"
        },
        "agency": {
          "name": "Illustrative Agency"
        },
        "sourceUrl": "https://example.invalid/awards/1",
        "observedAt": "2026-09-30T12:00:00.000Z",
        "entity": null,
        "revenueComparison": null
      },
      {
        "id": "2222222222222222222222222222222222222222",
        "revisionId": "5555555555555555555555555555555555555555",
        "source": "usaspending",
        "sourceAwardId": "ILLUSTRATIVE-2",
        "jurisdiction": "US",
        "awardType": "prime",
        "title": "Illustrative procurement 2",
        "awardDate": "2026-09-30",
        "currency": "USD",
        "obligatedAmount": "200",
        "recipient": {
          "name": "Illustrative Company"
        },
        "agency": {
          "name": "Illustrative Agency"
        },
        "sourceUrl": "https://example.invalid/awards/2",
        "observedAt": "2026-09-30T12:00:00.000Z",
        "entity": null,
        "revenueComparison": null
      },
      {
        "id": "3333333333333333333333333333333333333333",
        "revisionId": "6666666666666666666666666666666666666666",
        "source": "usaspending",
        "sourceAwardId": "ILLUSTRATIVE-3",
        "jurisdiction": "US",
        "awardType": "prime",
        "title": "Illustrative procurement 3",
        "awardDate": "2026-09-30",
        "currency": "USD",
        "obligatedAmount": "300",
        "recipient": {
          "name": "Illustrative Company"
        },
        "agency": {
          "name": "Illustrative Agency"
        },
        "sourceUrl": "https://example.invalid/awards/3",
        "observedAt": "2026-09-30T12:00:00.000Z",
        "entity": null,
        "revenueComparison": null
      }
    ],
    "nextCursor": null,
    "agencies": [],
    "sectors": [],
    "leaders": [],
    "history": [],
    "alerts": [],
    "sources": [],
    "coverage": [],
    "gaps": [],
    "locked": true
  },
  "meta": {
    "dataset": "awards",
    "asOf": null,
    "source": [
      {
        "id": "usaspending",
        "attribution": "USAspending.gov",
        "licence": "U.S. public government data"
      },
      {
        "id": "ted",
        "attribution": "European Union TED",
        "licence": "Reuse with attribution"
      },
      {
        "id": "uk-contracts",
        "attribution": "UK Contracts Finder and Find a Tender",
        "licence": "Open Government Licence v3"
      },
      {
        "id": "canada-contracts",
        "attribution": "Government of Canada",
        "licence": "Open Government Licence Canada"
      },
      {
        "id": "gleif",
        "attribution": "GLEIF",
        "licence": "CC0"
      }
    ],
    "historyStarts": null,
    "coverage": null,
    "lastUpdated": null,
    "sample": true,
    "note": "ILLUSTRATIVE: synthetic examples showing the response fields; not real company disclosures or published observations."
  }
}

Meta fields

Field

dataset

Here

The dataset id

In the example

"awards"

Field

asOf

Here

The newest observed award time in the response

In the example

null

Field

source

Here

Attribution and licence of each source

In the example

5 sources

Field

historyStarts

Here

Earliest stored history when established by the service; otherwise null.

In the example

null, not stated yet

Field

coverage

Here

Service-established coverage; null when unavailable.

In the example

null

Field

lastUpdated

Here

The newest observation or successful source read

In the example

null

Sources

Source

USAspending.gov

Licence

U.S. public government data

Source

European Union TED

Licence

Reuse with attribution

Source

UK Contracts Finder and Find a Tender

Licence

Open Government Licence v3

Source

Government of Canada

Licence

Open Government Licence Canada

Source

GLEIF

Licence

CC0

Errors

These routes can answer 400, 401, 402, 403, 404, 429, 503. See Errors for the codes.

Gloom Datasets reads stored data only: a call never starts a collection.