Flag of ScotlandScottish Health Data

Documentation

Guidance around API usage and specific endpoint documentation.

The REST API can be accessed on https://api.healthdata.scot with the obtained API key.

Results are paginated and by default, the first 100 results are returned, which can be changed by the limit query parameter. To get the next pages use the returned _meta.cursor as the value for the cursor query parameter.

This endpoint exposes the GP Practices and List sizes April 2025 dataset with the following transformation:

  • Remove whitespace from TelephoneNumber.
  • Return null for Dispensing instead of ' '.
  • Enriched with geospatial data to add Latitude, Longitude, and H3 H3Res<n> fields.

This endpoint exposes the NHS Hospitals in Scotland updated in June 2025 dataset with the following transformation:

  • Normalise whitespace in Postcode to always have whitespace before the inward code.
  • Enriched with geospatial data to add Latitude, Longitude, and H3 H3Res<n> fields.

This endpoint exposes the Dental Practices September 2024 dataset with the following transformation:

  • Rename pc7 to postcode and normalise to always have whitespace before the inward code.
  • Enriched with geospatial data to add Latitude, Longitude, and H3 H3Res<n> fields.