Public Projects List

Request

Cursor-paginated list of projects 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.

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

object_numberstring or null(Object Number)

Filter to projects with this ERP-facing grouping key. Not unique — multiple projects may share an object_number and all matches are returned across the page.

request_idinteger or null(Request Id)

Filter to the project linked to this Mercura request id (via the Request.project_id FK). Returns an empty page for requests with no project FK.

statusstring or null(Status)

Filter to projects in this lifecycle status. One of ACTIVE, PROCESSED, BID_SUBMITTED, CUSTOMER_LOST, CUSTOMER_WON_PENDING, CUSTOMER_WON_AWARDED_ELSEWHERE, CUSTOMER_WON_AWARDED_TO_US. Unknown values return 400.

authorizationstring or null(Authorization)

Bearer <mrc_live_…> API key

curl -i -X GET \
  'https://docs.mercura.ai/_mock/openapi/projects?cursor=string&modified_since=2019-08-24T14%3A15%3A22Z&limit=1&object_number=string&request_id=0&status=string' \
  -H 'authorization: string'

Responses

Successful Response

Bodyapplication/json

dataArray of objects(Data)required

Example:

[
  {
    "acknowledgement": { … },
    "construction_site_address": { … },
    "created_at": "2026-07-08T09:10:00Z",
    "currency": "EUR",
    "custom_fields": { … },
    "estimated_value": 185000,
    "id": "90",
    "name": "Neubau Bürogebäude Rheinpark",
    "object_number": "OBJ-2026-0042",
    "planner_address": { … },
    "request_ids": [ … ],
    "responsible_user": { … },
    "status": "ACTIVE",
    "submission_date": "2026-08-15",
    "updated_at": "2026-07-09T12:00:12Z"
  }
]

next_cursorstring or null(Next Cursor)

Response

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