Make your first request

Create a key

API and MCP access are included with Scale. An organisation owner or admin can create a key in Settings → Developers. Give each integration its own key, select its permissions and choose an expiry.

Copy the key when it is created. Tendex only stores its hash, so the full key cannot be shown again.

Search for opportunities

Set TENDEX_API_KEY in your server's environment or secret manager. Then run:

curl --get 'https://api.tendex.ai/v1/tenders' \
  --header "Authorization: Bearer $TENDEX_API_KEY" \
  --data-urlencode 'q=software' \
  --data-urlencode 'limit=20'

The response contains a data array and a pagination object. Results are ordered by publication date, newest first. These are public procurement records; personal bookmarks, workspace documents and company match scores are not included.

Retrieve a tender

Use an id from the search response. The key needs the tenders:read permission.

curl "https://api.tendex.ai/v1/tenders/$TENDER_ID" \
  --header "Authorization: Bearer $TENDEX_API_KEY"

The response's data object contains the tender's full description, buyer, value, dates, source and original URL. Missing values are null. A tender without a matching record returns 404.

Explore the contract

Open the interactive API reference to inspect parameters and try requests with your key. The OpenAPI document can generate clients in your preferred language.