---
url: https://docs.tenderapi.eu/search-organisations.md
description: >-
  Find buyers and suppliers by name or country, and get the organisation id used
  by the other endpoints.
---

# 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](/organisation-tenders) to list everything an organisation has bought or won.

## Endpoint

```
POST /api/v1/organisations/search
```

## Example

::: code-group

```bash [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 [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"])
```

```ts [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](/getting-started#country-codes), for example `SVN`. |
| `limit` | `integer` | Results per page. Default 25, maximum 100. |
| `cursor` | `string` | Cursor from a previous response. See [Pagination](/pagination). |

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

## Response

```json
{
  "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](/get-organisation) and [Organisation Tenders](/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](/pagination) for `nextCursor` and `total`.