---
title: "Get organisation details"
method: GET
path: "/Organization/{id}"
---

# Get organisation details

`GET /Organization/{id}`

## Overview
Use this endpoint to get details for a single organisation based on its ODS code. Site codes which are supported for certain organisations can also be accessed here, there is not a separate endpoint for sites. 

A FHIR Organization resource will be provided when a valid id has been provided. Refer to our [Implementation Guidance](https://simplifier.net/guide/organisation-data-services/Home/FHIR-Assets/Profiles#UKCore-Organization) pages for profiles and other FHIR assets.


## What is included    
This API returns the following details for an organisation: 

  * organisation - ODS code, name, last change date, status if active or inactive, record class (organisation or site), record use type; A complete record or a reduced record included solely for referential integrity
  * address - house or flat number, line 1, line 2, line 3, town, postcode, Unique Property Reference Number (UPRN) and country
  * contacts - website and telephone (where available)
  * roles - primary and non-primary roles including legal and operational start and end dates 


To access a richer Organisation dataset, use the ods-organization-code CodeSystem, when searching the CodeSystem resource with an ODS Code, in addition to the above, the following will also be returned: 

  * organisation –Assigning Authority
  * related entities, the current related entity of any supported relationships
  * succession - any predecessors and/or successors and a flag to indicate the successor has also been succeeded
  * geographic - the appropriate mapping from the postcode dataset including Local Authority, Integrated Care Board or 2011 Lower Super Output Area (LSOA11)

## Path parameters

- `id` string, required

## Response `200`

Valid request that returns a FHIR Organisation resource

## Other responses

- `404` — Invalid ODS Code provided, will return a 404 Not Found error

## Changes

- **2026-02-24** `c2df8e70fcf4` — 1 info
  - endpoint added
- **2024-07-03** `b1045964452f` — 1 breaking
  - api path removed without deprecation
- **2024-07-02** `b0eaaa9d2314` — 1 info
  - endpoint added
- **2024-05-02** `d0f29cae5794` — 1 breaking
  - api path removed without deprecation
- **2024-04-25** `3eace168885f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/nhs/apis/organisation-data-terminology-api-2/changes/Organization/:id/get.md)

---

[API](https://skmtc.dev/nhs/apis/organisation-data-terminology-api-2.md) · [All operations](https://skmtc.dev/nhs/apis/organisation-data-terminology-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nhs/organisation-data-terminology-api-2/revisions/c2df8e70fcf4/schema)