# Gloom Awards Lookup by ID

> Gloom Awards Lookup by ID is a paid API for AI agents from api.gloom.sh, paid per call via x402, $0.3/call, status unknown (last checked 2026-11-01).

Retrieves details for a specific government or financial award record by its unique ID, sourced from USASpending and similar databases.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/awards/%7Bid%7D?utm_source=zero.xyz
- Price: $0.3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-awards-lookup-by-id-b0aa5dc2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hudehQCXlqwZl0vHjPZF8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gloom-awards-lookup-by-id-b0aa5dc2
```

Example prompt: Can you pull up the award record for ID ILLUSTRATIVE-1 from the Gloom awards API and tell me the award type, date, jurisdiction, and current status?

## When to prefer this

Use this endpoint when you need structured metadata about a specific government or federal award and already have the award ID. It is ideal for cross-referencing USASpending award records, verifying contract details, or enriching datasets with award-level information. Prefer this over general web search when you need structured, machine-readable award data with consistent field names.

## Known failure modes

- Invalid or unknown award ID returns an empty or 404 response
- Malformed ID path parameter causes a 400 bad request error
- Award record exists in source database but has null fields for status, description, or period dates
- Rate limiting or payment failure returns a 402 or 429 response
- Source data from USASpending may be delayed or incomplete for recent awards

## How this service works

Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.

## Output

A JSON object containing award metadata including source (e.g. 'usaspending'), award date, award type (e.g. 'prime'), award status, performance period start and end dates, jurisdiction (e.g. 'US'), description, and the original source award ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "source": "usaspending",
   "awardDate": "2026-09-30",
   "awardType": "prime",
   "dateBasis": null,
   "periodEnd": null,
   "awardStatus": null,
   "description": null,
   "periodStart": null,
   "jurisdiction": "US",
   "sourceAwardId": "ILLUSTRATIVE-1"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-awards-lookup-by-id-b0aa5dc2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gloom.sh](https://www.zero.xyz/host/api.gloom.sh/llms.txt)