---
title: "Search published notices. OR within each selected filter, AND across filters and text. Omitted statuses use active defaults; statuses= includes all. Fixed page size 20."
method: GET
path: "/tenders"
---

# Search published notices. OR within each selected filter, AND across filters and text. Omitted statuses use active defaults; statuses= includes all. Fixed page size 20.

`GET /tenders`

## Request

- Base URL: `https://tenders-api.zephior.com/v1`
- URL: `https://tenders-api.zephior.com/v1/tenders`
- Auth: none required

Search published notices. OR within each selected filter, AND across filters and text. Omitted statuses use active defaults; statuses= includes all. Fixed page size 20.

## Query parameters

- `q` string
- `countries` string[]
- `categories` string[]
- `statuses` string[]: Omit for active statuses (open, closing-soon, upcoming, unconfirmed). An explicit empty array includes all statuses. closing-soon is an open notice whose deadline is within 7 days (168 hours); a passed deadline shows as closed. OR within each filter, AND between filters and text search.
- `buyer` string
- `sort` 'relevance' | 'deadline' | 'newest'
- `page` integer
- `locale` 'en' | 'de' | 'fr'

## Response `200`

Published public information

- object
  - `items` object[], required
    - `id` string, required
    - `url` string, uri, required
    - `title` string, required
    - `summary` string, required
    - `locale` 'en' | 'de' | 'fr', required
    - `status` 'open' | 'closing-soon' | 'closed' | 'awarded' | 'cancelled' | 'suspended' | 'upcoming' | 'unconfirmed', required
    - `recordedStatus` 'open' | 'closing-soon' | 'closed' | 'awarded' | 'cancelled' | 'suspended' | 'upcoming' | 'unconfirmed', required
    - `sourceStatus` string
    - `country` string
    - `revision` integer
    - `stale` boolean
    - `modifiedAt` string, required
    - `sourceCheckedAt` string
    - `deadline` object, required
      - `at` string, nullable, required
      - `date` string, nullable, required
      - `precision` 'instant' | 'date' | 'unavailable', required
    - `originalSource` object, required
    - `sources` object[], required
  - `total` integer, required
  - `page` integer, required
  - `limit` 20, required
  - `filters` object, required
  - `locale` 'en' | 'de' | 'fr', required
  - `url` string, required
  - `nextPage` integer, nullable, required

## Other responses

- `400`: Invalid request or query parameter.
- `404`: The requested resource does not exist or has expired.
- `429`: Public API rate limit exceeded.
- `503`: Published notices are temporarily unavailable.

---

[API](https://skmtc.dev/zephior/apis/zephior-public-discovery-api.md) · [All operations](https://skmtc.dev/zephior/apis/zephior-public-discovery-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zephior/apis/zephior-public-discovery-api/revisions/3d7585b2bd5a?raw)