# OregonBuys · Search bids

Search public records with OregonBuys · Search bids from Alexandria through one Spiral API key. Find solicitations by keyword (description, item description, bid number, alternate id), organization, buyer, type code, status, category or opening-date window; pass a row's `bid_number` to get_bid. Use list_open_bids instead for the site's curated list of currently open solicitations. 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` / `oregonbuys-gov/public-tenders/search_bids`
- Page: https://spiral.ai/tools/alexandria/oregonbuys-gov/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 name text. |
| `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 | NN, SS, RI, IB, EP, GS, SP, 3Q, RP, RQ | — | Solicitation type: NN Other Public Notice, SS Sole Source Notice, RI Request for Information, IB Invitation to Bid, EP Emergency Procurement, GS GSA Notice, SP Special Procurement Notice, 3Q Three Quote Process (Closed), RP Request for Proposal, RQ Request for Quote. |
| `bid_number` | text |  | — | Bid solicitation number or prefix, e.g. `S-44000-00017920` (the form's Bid # field). |
| `organization` | text |  | — | Organization name text, e.g. `Department of Transportation`. |
| `category_code` | text |  | — | Two-digit OregonBuys category, e.g. `08` Computers, Software, Supplies, and Services; `22` Public Works, Park Equipment, and Construction Services. Pattern: ^(0[1-9]\|[12][0-9]\|3[0-2])$. |
| `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": "oregonbuys-gov/public-tenders/search_bids",
    "input": {
      "buyer": "<buyer>"
    }
  }'
```

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

## Common questions

### OregonBuys · Search bids

**How much does OregonBuys · 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 OregonBuys · Search bids through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "oregonbuys-gov/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 OregonBuys · Search bids?**

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

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

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

