---
title: "Search for organisations"
method: POST
path: "/"
tags: ["Organisation"]
---

# Search for organisations

`POST /`

## Overview
Use this endpoint to find information about services provided by NHS organisations.

For more information on how to use search identifiers with this endpoint, see [DoHS API guide to search identifiers and service codes](https://digital.nhs.uk/developer/api-catalogue/directory-of-healthcare-services/guide-to-search-identifiers-and-service-codes).

## Sandbox test scenarios
You can test the following scenarios in our sandbox environment:

| Scenario               | Request                    | Response                                 |
| ---------------------- | -------------------------- | ---------------------------------------- |
| All organisations      | No parameters              | HTTP status 200 with all organisations   |
| Single organisation    | `search`=`Y02494`           | HTTP status 200 with single organisation |
| No organisations found | `search`=`no-organisation` | HTTP status 200 with no organisations    |
| Invalid API version    | No api-version parameter   | HTTP status 404 with problem description |

You can try out the sandbox using the 'Try this API feature' on this page.

## Query parameters

- `api-version` number, required

## Request body

- OrganisationPostRequest — Organisation post request

## Response `200`

Organisation post response

## Other responses

- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/nhs/apis/service-search-api.md) · [All operations](https://skmtc.net/nhs/apis/service-search-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nhs/service-search-api/versions/ed9300a18c4f/schema)