live

Hse APIwww2.hse.ie ↗

Find nearby pharmacies in Ireland that offer flu and COVID-19 vaccines through the HSE's official database. Search vaccine locations by your area to quickly locate available vaccination services.

Endpoint health

monitored

search_vaccine_locations

Checks pendingself-healing

Endpoints

Updated

4h ago

Try it

page

Page number for pagination. 10 results per page.

service

Filter by vaccine service type. Omitted returns all locations regardless of service.

latitude

Latitude coordinate for location-based search (decimal degrees, e.g. 53.3498). When provided with longitude, results are sorted by distance from this point.

longitude

Longitude coordinate for location-based search (decimal degrees, e.g. -6.2603). Must be provided together with latitude.

location_name

Human-readable name for the search location (e.g. 'Dublin, Ireland'). Used for display purposes in distance-sorted results. Defaults to the coordinate values if omitted.

→ api.parse.bot/scraper/afa39ada-1fe6-441b-b20d-82a03908a79a/<endpoint>

Ready to send

Fill in the parameters and hit sign in to send to see live response data here.

Call it over HTTPgrab a free API key at signup

curl -X GET 'https://api.parse.bot/scraper/afa39ada-1fe6-441b-b20d-82a03908a79a/search_vaccine_locations?page=1&service=adult-flu-vaccine&latitude=53.3498&longitude=-6.2603&location_name=Dublin%2C+Ireland' \
  -H 'X-API-Key: $PARSE_API_KEY'

Python SDK · recommended

Typed, relational, agent-ready

A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.

Fully typed · autocompletes
Objects link to objects
Typed errors & pagination

Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:

uv add parse-sdk
uv run parse init
uv run parse add --marketplace www2-hse-ie-api

uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.


"""Walkthrough: HSE Vaccine Finder — search pharmacies offering vaccines in Ireland."""
from parse_apis.www2_hse_ie_api import HSEVaccine, VaccineService, LocationHashError

client = HSEVaccine()

# Search all vaccine locations (alphabetical), capped at 5
for loc in client.vaccine_locations.search(limit=5):
    print(loc.name, loc.county, loc.eircode)

# Filter by COVID-19 vaccine service
covid_location = client.vaccine_locations.search(
    service=VaccineService.COVID_19, limit=1
).first()
if covid_location:
    print(covid_location.name, covid_location.services, covid_location.phone)

# Location-based search near Dublin, sorted by distance
nearby = client.vaccine_locations.search(
    latitude="53.3498", longitude="-6.2603", location_name="Dublin, Ireland", limit=3
)
for loc in nearby:
    print(loc.name, loc.distance_meters, loc.town)

# Typed error handling
try:
    result = client.vaccine_locations.search(
        latitude="invalid", longitude="bad", limit=1
    ).first()
except LocationHashError as exc:
    print(f"Location error: {exc}")

print("exercised: vaccine_locations.search (all / filtered / geo-sorted / error)")

All endpoints · 1 totalmissing one? ·

Search for pharmacies and locations offering vaccines in Ireland. Returns paginated results sorted alphabetically by default, or by distance when coordinates are provided. Supports filtering by vaccine service type. Each result includes pharmacy details, address, contact information, services offered, and optional booking links.

Input

Param	Type	Description
page	integer	Page number for pagination. 10 results per page.
service	string	Filter by vaccine service type. Omitted returns all locations regardless of service.
latitude	string	Latitude coordinate for location-based search (decimal degrees, e.g. 53.3498). When provided with longitude, results are sorted by distance from this point.
longitude	string	Longitude coordinate for location-based search (decimal degrees, e.g. -6.2603). Must be provided together with latitude.
location_name	string	Human-readable name for the search location (e.g. 'Dublin, Ireland'). Used for display purposes in distance-sorted results. Defaults to the coordinate values if omitted.

Response

{
  "type": "object",
  "fields": {
    "page": "integer",
    "locations": "array of vaccine location objects with pharmacy details",
    "page_size": "integer",
    "total_count": "integer",
    "total_pages": "integer"
  },
  "sample": {
    "data": {
      "page": 1,
      "locations": [
        {
          "id": 2906,
          "kind": "Pharmacy",
          "name": "Hickey's Pharmacy Henry Street",
          "slug": "hickeys-pharmacy-henry-street",
          "town": "Dublin City",
          "phone": "+1 (555) 012-3456",
          "county": "Dublin",
          "eircode": "D01 AK46",
          "website": null,
          "address1": "6 Henry Street",
          "address2": "",
          "latitude": 53.3495558,
          "services": [
            "Adult flu vaccine",
            "Children's flu vaccine",
            "COVID-19 vaccine"
          ],
          "longitude": -6.2612128,
          "booking_url": "https://www.hickeyspharmacies.ie/hickeys-booking-portal",
          "distance_meters": 66,
          "google_maps_link": null
        }
      ],
      "page_size": 10,
      "total_count": 1409,
      "total_pages": 141
    },
    "status": "success"
  }
}

About the Hse API

The Hse API on Parse exposes 1 endpoint for the publicly available data on www2.hse.ie. Calls return JSON over HTTPS and are billed per successful response.

Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.