Filtering

The search and alert results endpoints accept a rich set of optional filters. All filters can be combined freely.

Text search

{ "text": "highway construction Spain" }

Status

Value	Meaning
Publicada	Open for bids
Adjudicada	Awarded
Resuelta	Resolved
Formalizada	Contract signed
Cerrada	Closed

{ "status": ["Publicada", "Adjudicada"] }

Deadline

{ "isOnlyWithinDeadline": true }

CPV codes

{ "cpvs": ["45000000-7", "72000000-5"] }

Locations

{ "locations": ["country/ES"] }
{ "locations": ["town/Madrid", "town/Barcelona"] }

Budget & amounts

{
  "minBudget": 50000,
  "maxBudget": 1000000
}

Dates

Filter pair	Description
minPublicationDate / maxPublicationDate	When the tender was published
minDeadlineDate / maxDeadlineDate	Submission deadline
minAwardingDate / maxAwardingDate	When the tender was awarded
minLastUpdateDate / maxLastUpdateDate	Last time the record was updated

{
  "minPublicationDate": "2024-01-01T00:00:00Z",
  "maxDeadlineDate": "2024-06-30T23:59:59Z"
}

Sorting

Value	Description
by-published-date	Publication date (default)
by-relevance	Relevance to text query
by-due-date	Submission deadline
by-budget	Budget amount

{ "sort": "by-due-date", "isDescendent": false }

Full example

curl -X POST https://api-rest.tendios.com/api/v1/tenders/search \
  -H "api-key: tend_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "software development",
    "status": ["Publicada"],
    "locations": ["country/ES"],
    "cpvs": ["72000000-5"],
    "minBudget": 50000,
    "isOnlyWithinDeadline": true,
    "sort": "by-due-date",
    "page": 1,
    "pageSize": 25
  }'