Tendersight API

Tender data for your systemsand your agents.

Search notices and read their documents, bids and buyers from your own software, through one API. Calls use the same credits as the app.

Start for free Read the API reference

Example request

curl https://api.tendersight.ai/v1/notices/search \
  -H "Authorization: Bearer $TENDERSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "searchText": "lift maintenance",
      "contractTypes": ["services"],
      "buyer": { "countries": ["AUT", "DEU"] },
      "deadline": { "from": "2026-11-16T00:00:00Z" },
      "estimatedValue": { "min": 250000 }
    },
    "pageSize": 20
  }'

Example response, shortened

{
  "items": [
    {
      "key": "not_01kf3m8q2vx7d9hk4tz6rbn5cw",
      "title": "Maintenance of lifts in federal buildings, 3 lots",
      "publicationDate": "2026-11-03T08:00:00+00:00",
      "estimatedValue": {
        "minAmount": null,
        "maxAmount": 1800000,
        "currency": "EUR",
        "minAmountEur": null,
        "maxAmountEur": 1800000
      },
      "buyers": [
        {
          "organizationKey": "org_01jz8r5t2kw4n6p9c3x7v1hmqd",
          "name": "Federal property agency",
          "country": "AUT",
          "fiscalId": "ATU12345678"
        }
      ],
      "milestones": [
        {
          "type": "deadline",
          "name": "Time limit for receipt of tenders",
          "date": "2026-12-01T10:00:00+00:00"
        }
      ],
      "contractType": "services",
      "primaryCpv": {
        "code": "50750000-7",
        "description": "Lift-maintenance services"
      },
      "biddability": "biddable",
      "nextDeadlineAt": "2026-12-01T10:00:00+00:00"
    }
  ],
  "continuationToken": "eyJhZnRlciI6WzEuOTQs…",
  "totalCount": 23
}

Notices from 28+ official sources

REST and MCP with one key

Credits per call, on every plan

The notices your team reads in Tendersight, delivered to your CRM, your data warehouse or your own agent.

The API reads the same index as Tendersight Leads. Use it to feed a sales pipeline, enrich buyer and supplier records, or give an agent its own tender search.

What the API returns.

Six kinds of data, across 9 endpoints.

Notice search
Filter by text, CPV code, buyer country and region, estimated value in euros, deadline, publication date and notice type.
Notice details
One notice by its key, with its buyers, estimated value, deadlines, award criteria, CPV code and procedure status.
Tender documents
The list of a notice's documents, and each file, downloaded through the API.
Bids and winners
Who bid on a notice, the value of each offer and who won, where the source publishes them.
Buyers and suppliers
Search the buyers that published notices by any part of their name or a fiscal identifier. Look up any buyer or supplier by its fiscal identifier or key.
Filter metadata
The filter values the search accepts and how many notices each one holds. This call uses no credits.

From sign-up to your first call.

An account, a key and one header. The API reference lists every endpoint, field and error.

01
Create a free account
Sign up for free. Every plan includes the API, and calls draw on the same credits as the rest of Tendersight.
02
Create an API key
A team owner opens API keys in the team settings, names the key and picks its scopes. The key is shown once, so store it safely.
03
Make your first call
Send the key as a Bearer token. Start with a notice search, then open the notices, documents and bids it returns.

Authentication: Authorization: Bearer tsk_live_…
Send the key with every call. It stops working as soon as it is revoked.
Scopes: notices:readdocuments:readawards:readorganizations:read
A key carries only the scopes you pick. A call outside them gets a 403.
Pagination: continuationToken
A search returns up to 100 notices a page and a token for the next one. Send the token back to continue.
Rate limits: 429Retry-After
10 requests a second and 100,000 a day per key by default. Past the limit, the API answers 429 and says when to retry.
Errors: application/problem+json
Problem details in JSON: 401 for a missing, unknown or revoked key, 402 when the team's credits cannot cover the call, 403 for a missing scope, 429 for too many requests.
Credits: X-Credits-ChargedX-RateLimit-Remaining
Each response says what the call used and how many requests are left. Only successful calls use credits.

Read the API reference OpenAPI document

Pay per call, in credits.

Calls draw on your team's credit balance, the same one Flow uses in the app. On Team, credits cost €2.50 per 1,000. A free account gets 2,000 credits at sign-up.

See plans and pricing

Credits per call to the Tendersight API
Call	Credits per call
A notice search `POST /v1/notices/search`	2
One notice `GET /v1/notices/{noticeKey}`	1
A notice's document list `GET /v1/notices/{noticeKey}/documents`	1
A document download `GET /v1/notices/{noticeKey}/documents/{documentId}`	5
The bids on a notice `GET /v1/notices/{noticeKey}/bids`	5
A buyer search `GET /v1/buyers?query=&limit=`	1
A buyer or supplier lookup by fiscal identifier `GET /v1/organizations?fiscalId=&limit=`	1
One buyer or supplier `GET /v1/organizations/{organizationKey}`	1
The search's filter values `GET /v1/meta/filters`	0

Only successful calls use credits.

The same data for your agents, over MCP.

Connect any MCP client to the Tendersight server with the same key. The tools follow the REST endpoints and use the same scopes and credits.

Example client configuration

{
  "mcpServers": {
    "tendersight": {
      "url": "https://api.tendersight.ai/mcp",
      "headers": {
        "Authorization": "Bearer tsk_live_…"
      }
    }
  }
}

search_noticesSearch notices with the same filters as the API
get_noticeRead one notice
list_notice_documentsList a notice's documents
list_notice_bidsList the bids on a notice
search_buyersFind buyers by name or fiscal identifier
get_organizationRead one buyer or supplier
search_organizationsFind buyers and suppliers by fiscal identifier

Tender data

Connections

Plans

Questions about the Tendersight API

Which tenders does the API cover?

The same notices as Tendersight Leads: public tenders from 28+ official sources, with their documents, the buyers and suppliers involved and, where the source publishes them, the bids and winners.

How much does a call cost?

Each successful call uses between 0 and 5 credits from your team's balance, depending on the endpoint. The table on this page lists every endpoint, and failed calls use none.

Can I try the API for free?

Yes. The API is on every plan, Free included. A free account gets 2,000 credits at sign-up, and API calls draw on them like the rest of Tendersight.

What are the rate limits?

10 requests a second and 100,000 a day per key by default. Past the limit the API answers 429 with a Retry-After header, and responses carry X-RateLimit-Limit and X-RateLimit-Remaining.

How current is the data?

Each call reads the same index the Tendersight app searches, and that index is updated daily from the official sources.

Who can create and revoke API keys?

Team owners, in the team settings. Each key has a name and its own scopes, is shown once when it is created and stops working as soon as it is revoked.

Create a key and make your first call.

Start for free, create an API key in the team settings and follow the API reference.

Start for free Read the API reference

Tender data for your systemsand your agents.

What the API returns.

Notice search

Notice details

Tender documents

Bids and winners

Buyers and suppliers

Filter metadata

From sign-up to your first call.

Create a free account

Create an API key

Make your first call