# A REST API for government tender and award data

*Source: [https://www.selltostate.com/features/tender-data-api/](https://www.selltostate.com/features/tender-data-api/)*

The Sell to State API gives your code the same data as the app: tenders, awards, buyers, suppliers and sectors, in one schema for every country.

## Prompt for your AI agent

```
1. Sign me in yourself. Try this first: you need me only for one approval click.
- If you can send HTTP requests: POST https://app.selltostate.com/api/v1/agent/signup with JSON {"client_name": "<your app name>"}. Show me verification_uri_complete from the reply as a link. I open it, sign up free with Google or email, and approve the code. Every "interval" seconds, POST token_endpoint with {"device_code": "<device_code>"} until the reply has access_token. Send access_token in the x-api-key header to the MCP server https://app.selltostate.com/api/mcp.
- If you cannot send HTTP requests: tell me to add the MCP server https://app.selltostate.com/api/mcp in this app. Its sign-in page also creates the free account. Claude: Customize > Connectors > Add custom connector. ChatGPT: chatgpt.com/plugins > + > Add custom MCP server, choose OAuth. Claude Code: claude mcp add --transport http selltostate https://app.selltostate.com/api/mcp, then /mcp > Authenticate.
2. The tools are free to connect. A free account gets plan_search 3 times a day and search for 2 different searches a day: titles, buyers, status and dates. Amounts, winners and notice links need a plan. Call whoami to see my plan. Read the skill at https://www.selltostate.com/skills/selltostate-tender-data-api/SKILL.md.
3. Using the Sell to State REST API with my API key, fetch the awards of the last 7 days for <what my company sells> in <countries> and push them to <my CRM or sheet>.
```

Skill for your AI agent: https://www.selltostate.com/skills/selltostate-tender-data-api/SKILL.md. All Sell to State skills: https://github.com/getbeton/selltostate-skills.

## Endpoints

Search, awards, tenders, buyers, suppliers and sectors, each with filters for country, dates, status and value. whoami shows the plan of the key. Every response has the same field names for every country.

## Authentication

Create an API key in your account and send it in the x-api-key header. An AI agent can get a key through the agent signup: the person approves and pays in the browser, and the agent receives the key.

## What teams build with it

A daily sync of new tenders into the CRM, a market dashboard in the BI tool, a Slack message for each new award of a competitor, or procurement data inside their own product.

## How it works

1. Pick a plan: The API is in every paid plan.
2. Create a key: In your account, or by agent signup.
3. Call the API: Header x-api-key.
4. Sync on a schedule: Poll by updated date.

## Who uses it

- Revenue operations teams that sync tenders into the CRM
- Data teams that load procurement data into a warehouse
- Developers of govtech and sales products

## Questions

### Is there a rate limit?

Yes, a per-key limit that fits a sync job and an interactive agent. The API answers 429 with Retry-After when you go over it.

### Is there an OpenAPI file?

Yes. The API page links the OpenAPI reference.

Pricing: https://www.selltostate.com/pricing/