Skip to main content
POST
/
api
/
nhs
/
services
/
search
/nhs/services/search
curl --request POST \
  --url https://api.anysite.io/api/nhs/services/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "postcode": "<string>",
  "count": 2,
  "timeout": 300,
  "filters": []
}
'
[
  {
    "id": "<string>",
    "name": "<string>",
    "@type": "@nhs_service_search_item",
    "org_type_code": "<string>",
    "address": "<string>",
    "phone": "<string>",
    "distance_miles": 123,
    "status": [],
    "registration_url": "<string>",
    "detail_url": "<string>"
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
service_type
enum<string>
required

Type of NHS service to search for

Available options:
gp,
dentist,
pharmacy,
hospital,
nhs_sight_test,
accident_and_emergency,
mental_health,
podiatrist,
sexual_health_clinic,
hiv_treatment,
breast_screening,
abdominal_aortic_aneurysm_screening,
diabetic_eye_screening,
chlamydia_screening,
sti_testing,
emergency_contraception,
free_condoms,
sexual_health_advice,
young_people_sexual_health,
rape_and_sexual_assault_referral,
drug_treatment,
drug_addiction_support,
stop_smoking,
healthwatch,
pals,
social_care,
pregnancy_testing,
sensory_impairments,
physical_disabilities
​
postcode
string
required

UK postcode to search around

Minimum string length: 1
Examples:

"SW1A 1AA"

"M1 1AE"

​
count
integer
required

Max number of results to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
filters
enum<string>[] | null

Restrict results to organisations matching these attributes

Available options:
GpAcceptingNewPatients,
GpAcceptingOutOfAreaPatients,
PharmacyOpenNow,
ConsultationRoom,
CarParking,
DisabledCarParking,
StepFreeAccess,
WheelchairAccess,
DentistAcceptingChildren,
DentistAcceptingAdults,
DentistAcceptingFreeCare

Response

Successful Response

​
id
string
required
​
name
string
required
​
@type
string
default:@nhs_service_search_item
​
org_type_code
string | null
​
address
string | null
​
phone
string | null
​
distance_miles
number | null
​
status
string[]
​
registration_url
string | null
​
detail_url
string | null