Pagination and search

Work through results in bounded pages.

Request a page

Search accepts q, source, region, limit and offset. All parameters are optional. The default page size is 20, with a maximum of 100. Offset starts at zero and cannot exceed 10,000. Unsupported or repeated parameters return 400.

GET /v1/tenders?q=software&limit=20&offset=0

Follow nextOffset

Each search response includes pagination:

{
  "limit": 20,
  "offset": 0,
  "total": 145,
  "nextOffset": 20
}

Send nextOffset as the next request's offset while keeping the same filters. Stop when nextOffset is null. It is also null when the searchable offset limit is reached; narrow your search to retrieve a more focused set of results.

Changing data

Results are ordered newest first and are not a frozen snapshot. New notices and updates can change page positions while you paginate. Deduplicate records by id if collecting multiple pages. The API is designed for bounded searches, not a complete database export.

Values and dates

Tender value is a numeric estimate with a separate currency. A missing value, currency, deadline, publication date or status is represented by null. Source dates retain their available precision. Use the original source URL to confirm the current procurement position.