# SAM.gov contract opportunity search

Search US federal contract opportunities (solicitations, presolicitations, sources sought, award notices) posted in a date window of at most one year. Needs posted from and posted to.

Search US federal contract opportunities (solicitations, presolicitations, sources sought, award notices) posted in a date window of at most one year, by NAICS, title, organization, set-aside and place of performance. Returns notice ID, title, agency path, type, set-aside, response deadline, NAICS, contacts and links.

- Tool ID: `sam-gov/opportunities`
- Provider: [SAM.gov](/providers/sam-gov.md)
- Capability: [B2B data](/tools/b2b-data.md)
- Price: no charge per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

No charge per call. A workspace is still needed so your agent can call it.


```json
{
  "model": "per_call",
  "amountUsd": 0
}
```

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "posted_from": {
      "type": "string",
      "pattern": "^[0-9]{2}/[0-9]{2}/[0-9]{4}$",
      "description": "Posted from, MM/dd/yyyy (window of one year at most), e.g. '01/01/2025'"
    },
    "posted_to": {
      "type": "string",
      "pattern": "^[0-9]{2}/[0-9]{2}/[0-9]{4}$",
      "description": "Posted to, MM/dd/yyyy, e.g. '03/31/2025'"
    },
    "ptype": {
      "type": "string",
      "enum": [
        "o",
        "p",
        "k",
        "r",
        "s",
        "a",
        "u",
        "g",
        "i"
      ],
      "description": "Notice type: o solicitation, p presolicitation, k combined synopsis/solicitation, r sources sought, s special notice, a award notice, u justification, g sale of surplus, i intent to bundle"
    },
    "naics": {
      "type": "string",
      "pattern": "^[0-9]{2,6}$",
      "description": "NAICS code, e.g. '541512'"
    },
    "title": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Words in the notice title, e.g. 'cloud migration'"
    },
    "organization": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Department or sub-tier name, e.g. 'GENERAL SERVICES ADMINISTRATION'"
    },
    "set_aside": {
      "type": "string",
      "pattern": "^[A-Z0-9]{2,10}$",
      "description": "Set-aside code, e.g. 'SBA' (small business) or '8A'"
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "Place of performance state, e.g. 'VA'"
    },
    "solicitation_number": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100,
      "description": "Exact solicitation number, e.g. '47QFCA25R0001'"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 10,
      "description": "Notices per page (1-100), e.g. 10"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000,
      "default": 0,
      "description": "Page index starting at 0, e.g. 0"
    }
  },
  "required": [
    "posted_from",
    "posted_to"
  ],
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "sam-gov/opportunities",
  "input": {
    "posted_from": "01/01/2025",
    "posted_to": "01/31/2025",
    "naics": "541512",
    "limit": 2
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

Licence: Public domain (U.S. Government work).

Attribution: Data from SAM.gov (U.S. General Services Administration).

[Provider documentation](https://open.gsa.gov/api/get-opportunities-public-api/)

[REST inspection](https://api.agentik.cc/v1/tools/sam-gov/opportunities) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/sam-gov/opportunities) · [Agent index](/llms.txt)