---
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

---

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