--- url: https://docs.tenderapi.eu/organisation-tenders.md description: List the tenders an organisation is involved in as a buyer, a winner, or both. --- # Organisation Tenders List the tenders an organisation is involved in, as a buyer, a winner, or both. Get the organisation id from [Search Organisations](/search-organisations). ## Endpoint ``` GET /api/v1/organisations/{id}/tenders ``` | Parameter | Type | Description | |---|---|---| | `id` | `string` | Organisation id (UUID). | ## Example Tenders this organisation has bought, closest deadline first. ::: code-group ```bash [cURL] curl "https://api.tenderapi.eu/api/v1/organisations/0192a6b4-51e2-7c3f-8d90-4a1b2c3d4e5f/tenders?roles=buyer&sortBy=deadline&limit=10" ``` ```python [Python] import requests org_id = "0192a6b4-51e2-7c3f-8d90-4a1b2c3d4e5f" res = requests.get( f"https://api.tenderapi.eu/api/v1/organisations/{org_id}/tenders", params={"roles": ["buyer"], "sortBy": "deadline", "limit": 10}, ) for tender in res.json()["tenders"]: print(tender["deadline"], tender["title"]) ``` ```ts [TypeScript] const orgId = "0192a6b4-51e2-7c3f-8d90-4a1b2c3d4e5f"; const params = new URLSearchParams({ roles: "buyer", sortBy: "deadline", limit: "10" }); const res = await fetch( `https://api.tenderapi.eu/api/v1/organisations/${orgId}/tenders?${params}`, ); const data = await res.json(); for (const tender of data.tenders) { console.log(tender.deadline, tender.title); } ``` ::: ## Query parameters All parameters are optional. | Parameter | Type | Description | |---|---|---| | `roles` | `string` | `buyer` or `winner`. Repeat the parameter for both, for example `?roles=buyer&roles=winner`. Default is both. | | `sortBy` | `string` | `publicationDate` (default), `deadline` or `estimatedValue`. See [Sorting](/pagination#sorting). | | `sortOrder` | `string` | `asc` or `desc`. Default depends on `sortBy`. | | `limit` | `integer` | Results per page. Default 25, maximum 100. | | `cursor` | `string` | Cursor from a previous response. See [Pagination](/pagination). | To find contracts a company has won, use `roles=winner`. ``` GET /api/v1/organisations/{id}/tenders?roles=winner&sortBy=estimatedValue ``` ## Response Same shape as [Search Tenders](/search-tenders#response): a `tenders` list and a `page` object. ```json { "tenders": [ { "id": "0195f1c2-7b3e-7a10-9c4d-3f2a8e6b1d05", "title": "Supply of hospital beds", "abstract": null, "status": "open", "serviceType": "supplies", "source": "enarocanje", "publicationDate": "2025-04-02T00:00:00Z", "deadline": "2025-05-12T21:59:59Z", "deadlineHasTime": false, "buyer": { "name": "Ministry of Health of the Republic of Slovenia", "country": "SVN" }, "cpvCodes": ["33192120"], "estimatedValue": null, "link": "https://www.enarocanje.si/#/pregled-objav/JN001234/2025" } ], "page": { "nextCursor": null, "total": { "count": 1, "capped": false } } } ``` If the organisation was merged into another one, results are for the merged organisation. See [Get Organisation](/get-organisation).