Public Tenders List

Request

Cursor-paginated list of tenders for the authed organisation.

Query

cursorstring or null(Cursor)

Opaque cursor from prior page

modified_sincestring or null, (date-time)(Modified Since)

ISO-8601 lower bound on updated_at. Applied only on the first page; the cursor is a strict super-set thereafter.

completed_sincestring or null, (date-time)(Completed Since)

ISO-8601 lower bound on completed_at. When set, returns the completion feed: only tenders completed at/after this instant, ordered by completed_at — e.g. everything completed in the last 5 minutes. completed_at is refreshed on every completion, so a re-exported tender reappears. Keep this parameter present on every page of the feed (its value is ignored once a cursor is supplied).

statusstring(Status)

Filter by lifecycle state (e.g. DONE).

Enum:"NEW""IN_PROGRESS""DONE""CANCELLED""PARSING""PARSING_FAILED"

limitinteger or null, [ 1 .. 500 ](Limit)

include_deletedboolean(Include Deleted)

Also report lines that were removed from the tender: they come back flagged (is_deleted / deleted_at) instead of being omitted, so an ERP that already imported the offer can drop what is no longer on it. Removals are reported per line: taking one article off a position yields that article flagged next to the position's live lines, and a position that vanished completely comes back with all of its lines flagged — so a consumer keyed on the ordinal number can still tell the two apart. Deleted lines never count toward totals, and a position merely flagged 'not relevant' is not a deletion and stays hidden.

Default:false

authorizationstring or null(Authorization)

Bearer <mrc_live_…> API key

curl -i -X GET \
  'https://docs.mercura.ai/_mock/openapi/tenders?cursor=string&modified_since=2019-08-24T14%3A15%3A22Z&completed_since=2019-08-24T14%3A15%3A22Z&status=NEW&limit=1&include_deleted=false' \
  -H 'authorization: string'

Responses

Successful Response

Bodyapplication/json

dataArray of objects(Data)required

Example:

[
  {
    "acknowledgement": { … },
    "branch": { … },
    "chapters": [ … ],
    "completed_at": "2026-07-09T11:59:58Z",
    "created_at": "2026-07-08T09:14:00Z",
    "customer_id": "K-10042",
    "deadline": "2026-08-13",
    "erp_offer_id": "AB-2026-5567",
    "id": "12345",
    "indirect_customer_id": "K-20099",
    "project_id": "90",
    "project_name": "Neubau Bürogebäude Nord",
    "request_custom_fields": { … },
    "request_id": "12345",
    "status": "DONE",
    "submission_date": "2026-08-20",
    "totals": { … },
    "updated_at": "2026-07-09T12:00:12Z",
    "user_custom_fields": { … },
    "user_email": "anna.schmidt@example.com"
  }
]

next_cursorstring or null(Next Cursor)

Response

{
  "data": [
    { … }
  ],
  "next_cursor": "string"
}