CQC Syndication

1.0.x
(1 review)

6. Organisation Re-registration

This page discusses how organisation re-registration is shown in the API and how to identify when a rating has been inherited from the previous organisation record.

Relationship Records

When an organisation re-registers it will show as a new organisation record in the API with a new organisation ID (locationId or providerId). The API response for the new organisation ID will include a HSCA Predecessor relationship from the new organisation to the old organisation. e.g. the API response for a location ID 1-222222222 may show a predecessor 1-111111111 as follows:

Request: https://api.cqc.org.uk/public/v1/locations/1-222222222

Response (abbreviated):

{
  "locationId": "1-222222222",

... snip ...

  "relationships": [
    {
      "relatedLocationId": "1-111111111",
      "relatedLocationName": "Example",
      "type": "HSCA Predecessor",
      "reason": "NHS Transfer"
    }
  ],

... snip ...

}

Location Ratings Inheritance

For registration applications completed from 1 April 2019, if an existing location (service) changes ownership or address, the new location will inherit the ratings and reports from the previous (predecessor) location.

When a rating in the API response includes an organisationId field, it indicates that the rating is inherited and identifies the location record which includes the inspection which contributes the rating. The reportLinkId corresponds to the linkId field of the inspection report in the API response of the predecessor organisation. The example below shows an overall rating which is current but which was inherited by 1-222222222 from location 1-111111111:

Request: https://api.cqc.org.uk/public/v1/locations/1-222222222

Response (abbreviated):

{
  "locationId": "1-222222222",

... snip ...

  "currentRatings": {
    "overall": {
      "rating": "Good",
      "reportDate": "2022-01-01",
      "reportLinkId": "f4fdb42e-7d01-44b6-9ad7-da130cf04273",
      "organisationId": "1-111111111",

... snip ...

}

Retrieving Reports for Inherited Ratings

More details about the inspection report can be obtained by make a separate HTTP request to retrieve the API response for the predecessor 1-111111111. The inspection record can be found from the reports object in that predecessor response with linkId attribute f4fdb42e-7d01-44b6-9ad7-da130cf04273

e.g.

Request: https://api.cqc.org.uk/public/v1/locations/1-111111111

Response (abbreviated):

{
  "locationId": "1-111111111",

... snip ...

  "reports": [
  {
    "linkId": "f4fdb42e-7d01-44b6-9ad7-da130cf04273",
    "reportDate": "2021-01-01",
    "firstVisitDate": "2020-11-01",
    "reportUri": "/reports/f4fdb42e-7d01-44b6-9ad7-da130cf04273"
  }

... snip ...

}

Reviews