> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altss.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Federal award search

> Search federal contract or grant awards by recipient, awarding agency or keyword within a date range.

Search federal contract or grant awards by recipient, awarding agency or keyword within a date range.

**Operation ID:** `procurement.award_search`. **Family:** [Government & Procurement](https://docs.altss.com/console/families/government-procurement.md).

[Read the live operation contract (JSON)](https://console.altss.com/v1/console/capabilities/procurement.award_search) for the current input and output schemas, price, limits and required scopes.

**Status:** Available (`AVAILABLE`). **Supported interfaces:** REST, MCP.

**Commercial status:** Available. Receive the structured result and receipt in Console after the run settles.

**Execution interfaces:** UI, REST, MCP.

## When to use it

Find awards in an industry or buyer segment before pursuing a contract.

## Price and billing unit

Request a quote for one federal award search. Review its inputs, delivery plan, use terms and maximum charge before accepting. Retrying the same purchase uses the same idempotency key.

**Price:** \$0.10. **Billing unit:** per successful search.

**Charge condition:** The authorized execution delivers a validated result and settles once. Failed pre-settlement executions are not charged; reservation release must be confirmed. Retrieve the same run if charge state is uncertain.

**Execution budget:** Maximum \$0.10 per accepted execution.

Fund your Console wallet, review the quote and approve the charge before execution.

## Inputs

Recipient, agency or keyword, award type, start and end date, and a limit of up to 25 results.

```json theme={null}
{
  "type": "object",
  "properties": {
    "recipient": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "pattern": "^[\\p{L}\\p{N} .,&'()/+-]+$"
    },
    "agency": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "pattern": "^[\\p{L}\\p{N} .,&'()/+-]+$"
    },
    "keyword": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "pattern": "^[\\p{L}\\p{N} .,&'()/+-]+$"
    },
    "awardKind": {
      "default": "contracts",
      "type": "string",
      "enum": [
        "contracts",
        "grants"
      ]
    },
    "fromDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "toDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "fromDate",
    "toDate"
  ],
  "additionalProperties": false
}
```

## Result and output schema

Award identifiers, amounts, awarding agencies, dates and official record links.

```json theme={null}
{
  "$ref": "https://console.altss.com/openapi.json#/components/schemas/Result_procurement_award_search"
}
```

## Examples

Illustrative request and result for this scope. The names, values and record references are examples. Actual delivery depends on the published availability and agreed scope.

### Example input

```json theme={null}
{
  "keyword": "software",
  "fromDate": "2025-01-01",
  "toDate": "2025-12-31",
  "limit": 5
}
```

### Example structured output

```json theme={null}
{
  "awards": [
    {
      "awardId": "EX-AWARD-42",
      "recipient": "Example Instruments",
      "title": "Calibration instruments",
      "awardedOn": "2025-06-30"
    }
  ]
}
```

## API example and execution

[Verified production contract](https://console.altss.com/openapi.json) · Base URL: `https://console.altss.com/v1/console`. Quote first. Obtain explicit approval of the price, plan and use terms before sending accept:true. Reuse the same purchase idempotency key on retries.

Required scope: `company.read`. Organization authority, funding checks and spending limits apply to paid execution.

Supply credentials in the documented authorization header. Replace a placeholder run ID with an actual authorized run ID.

```json theme={null}
{
  "method": "POST",
  "url": "https://console.altss.com/v1/console/quote",
  "body": {
    "toolId": "procurement.award_search",
    "input": {
      "keyword": "software",
      "fromDate": "2025-01-01",
      "toDate": "2025-12-31",
      "limit": 5
    }
  }
}
```

This example requests a quote. A paid run requires the unchanged returned quote, explicit acceptance and a stable idempotency key.

## MCP and A2A

**Supported interfaces:** REST, MCP. Current MCP tools: `altss_quote`, `altss_run`, `altss_get_run`. Inspect tools/list and inputSchema before use. Paid A2A execution is unavailable. The separate anonymous A2A reader serves public information.

[REST guide](https://docs.altss.com/console/rest.md) · [MCP guide](https://docs.altss.com/console/mcp.md) · [A2A scope](https://docs.altss.com/console/a2a.md) · [Authentication and credentials](https://docs.altss.com/console/authentication.md)

## Sources, evidence and freshness

* Public records and official sources
* Altss intelligence and source collections

Retain source attribution, observation and event dates, evidence and explicit unknowns where supplied. A record update is not independent verification.

Historical source collection dates describe when the material was observed. Coverage and freshness depend on each returned source. Preserve its observation date and use restrictions with the result.

## Limits and permitted use

* Includes: Award identifiers, amounts, awarding agencies, award dates and official record links. Excludes: subawards and transaction history; recipient contact details or personal identifiers; legal or eligibility determinations; bulk export or paging beyond 25. Requires scope company.read. Source: public procurement records.
* A timeout does not establish the final charge. Retrieve the existing run before retrying.

Use is limited by the accepted quote or agreed delivery scope, source restrictions and privacy controls. Storage, attribution, retention, redistribution and training permissions do not expand through normalization.

## Next step

[Try Console](https://console.altss.com/signup?src=buyer-intent\&cta=capability\&capability=procurement.award_search) · [Open Console workspace](https://console.altss.com/console/playground/new?capability=procurement.award_search) · [View the capability on Altss](https://altss.com/console/capabilities/procurement.award_search) · [Wallet and billing](https://docs.altss.com/console/billing.md)

[Back to Government & Procurement](https://docs.altss.com/console/families/government-procurement.md) · [All capabilities](https://docs.altss.com/console/capabilities.md) · [Price schedule](https://docs.altss.com/console/prices.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.