Search Organisations

Find organisations by name or country. An organisation is any party named in a tender, either the buyer (contracting authority) or a winner. Use the returned id with Organisation Tenders to list everything an organisation has bought or won.

Endpoint

POST /api/v1/organisations/search

Example

cURL

curl -X POST https://api.tenderapi.eu/api/v1/organisations/search \
  -H "Content-Type: application/json" \
  -d '{"name": "Ministry of Health", "countries": ["SVN"], "limit": 10}'

Python

import requests

res = requests.post(
    "https://api.tenderapi.eu/api/v1/organisations/search",
    json={"name": "Ministry of Health", "countries": ["SVN"], "limit": 10},
)
for org in res.json()["organisations"]:
    print(org["id"], org["name"])

TypeScript

const res = await fetch("https://api.tenderapi.eu/api/v1/organisations/search", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ name: "Ministry of Health", countries: ["SVN"], limit: 10 }),
});
const data = await res.json();
for (const org of data.organisations) {
  console.log(org.id, org.name);
}

Request body

All fields are optional.

Field	Type	Description
name	string	Organisations whose name contains this text. Case insensitive, ignores accents, punctuation and legal forms like GmbH or d.o.o..
countries	string[]	Three letter country codes, for example SVN.
limit	integer	Results per page. Default 25, maximum 100.
cursor	string	Cursor from a previous response. See Pagination.

Results are ordered from oldest to newest organisation. There is no sorting option on this endpoint.

Response

{
  "organisations": [
    {
      "id": "0192a6b4-51e2-7c3f-8d90-4a1b2c3d4e5f",
      "name": "Ministry of Health of the Republic of Slovenia",
      "country": "SVN",
      "registrationId": "5030544000"
    }
  ],
  "page": {
    "nextCursor": null,
    "total": { "count": 1, "capped": false }
  }
}

Organisation

Field	Type	Description
id	string	Unique id. Use it with Get Organisation and Organisation Tenders.
name	string	Organisation name as published.
country	string | null	Three letter country code, when known.
registrationId	string | null	National registration or tax number, when known.

Page

See Pagination for nextCursor and total.