# COMMBUYS · Search bids

Search public records with COMMBUYS · Search bids from Alexandria through one Spiral API key. Find solicitations by keyword (description; with `match: any` also item description, bid number and alternate id), organization (agency), buyer, NIGP class, type code, status, UNSPSC category or opening-date window; pass a row's `bid_number` to get_bid and a `blanket_number` to get_blanket. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Public Records
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `commbuys-com/public-tenders/search_bids`
- Page: https://spiral.ai/tools/alexandria/commbuys-com/public-tenders/search_bids

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `buyer` | text |  | — | Buyer id as the site uses it (e.g. `AUDREY.BANKS`) or the buyer's name as listed (`Last, First`); a unique fragment is accepted. |
| `match` | one of | all, any | all | `all` (default): every filled criterion must match (the form's default). `any`: the site's Any/OR switch; the keyword is copied into the description, item description, bid number and alternate id fields, and a row matches when ANY filled criterion matches - so combining `any` with `status` or `type_code` returns every bid with that status or type, not the intersection. Use `any` for keyword-only quick searches and `all` when combining filters. |
| `cursor` | text |  | — | Row offset of the page to return (a multiple of 25), as given by the previous answer's `next_cursor`. Omit for the first page. The same criteria must be passed again; the site's session is re-established on every call. Pattern: ^[0-9]{1,6}$. |
| `status` | one of | 2BA, 2BCL, 2BE, 2BIA, 2BO, 2BPO, 2BS | — | Status code: 2BA Approved, 2BCL Closed, 2BE Evaluated, 2BIA Intent To Award, 2BO Opened, 2BPO Bid to PO, 2BS Sent (open for responses). |
| `keyword` | text |  | — | Free text matched against the solicitation description (the form's Description field). With `match: any` it is also applied to the item description, bid number and alternate id, as the site's quick search does. |
| `type_code` | one of | NS, SH, SS | — | Solicitation type: NS Non-Statewide Solicitation, SH Historical Solicitation, SS Statewide Solicitation. |
| `bid_number` | text |  | — | Bid solicitation number or prefix, e.g. `BD-27-1060-ITD00-ITD00-133949` or `BD-27-1060` (the form's Bid # field). |
| `nigp_class` | text |  | — | NIGP class code of the form's NIGP Class dropdown, e.g. `43-23`. Pattern: ^[0-9]{2}-[0-9]{2}$. |
| `organization` | text |  | — | Organization (agency) code as the site uses it, e.g. `1060`, or its name as listed, e.g. `Executive Office of Technology Services and Security`; a unique case-insensitive fragment of the name is accepted, an ambiguous one is rejected with candidates. |
| `category_code` | text |  | — | UNSPSC segment of the form's Category dropdown: the two-digit code, e.g. `43` (Information Technology Broadcasting and Telecommunications) or `00` (Grants), or a unique fragment of its name. |
| `opening_date_to` | text |  | — | Bid opening date upper bound, MM/DD/YYYY. Pattern: ^(0[1-9]\|1[0-2])/(0[1-9]\|[12][0-9]\|3[01])/[0-9]{4}$. |
| `opening_date_from` | text |  | — | Bid opening date lower bound as the form takes it, MM/DD/YYYY. Pattern: ^(0[1-9]\|1[0-2])/(0[1-9]\|[12][0-9]\|3[01])/[0-9]{4}$. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "commbuys-com/public-tenders/search_bids",
    "input": {
      "buyer": "<buyer>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=commbuys-com%2Fpublic-tenders%2Fsearch_bids

## Common questions

### COMMBUYS · Search bids

**How much does COMMBUYS · Search bids cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use COMMBUYS · Search bids through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "commbuys-com/public-tenders/search_bids"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use COMMBUYS · Search bids?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use COMMBUYS · Search bids?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

