---
title: "Developer and API documentation | Rockfield Pharmacy"
description: "The public read-only REST API, its OpenAPI description, the MCP server, rate limits, error shape and versioning policy."
canonical: "https://rockfieldpharmacy.vercel.app/developers"
---

# Developer and API documentation | Rockfield Pharmacy

> The public read-only REST API, its OpenAPI description, the MCP server, rate limits, error shape and versioning policy.

## Endpoints

Base URL: `https://rockfieldpharmacy.vercel.app/api/v1` · no authentication · read-only · JSON.

- `GET /api/v1` — This document: every endpoint, the OpenAPI and MCP URLs, auth and versioning policy.
- `GET /api/v1/pharmacy` — Name, address, phone, email, opening hours, PSI registration.
- `GET /api/v1/services` — Every service, with the page that starts it.
- `GET /api/v1/conditions` — Conditions covered by the HSE Common Conditions Service.
- `GET /api/v1/conditions/{id}` — One condition, with its information sections.
- `GET /api/v1/pricing` — Published fees, and which prices are quoted per patient.
- `GET /api/v1/availability?date=YYYY-MM-DD` — Consultation slots free on a date, live from the booking calendar.

Machine-readable description: https://rockfieldpharmacy.vercel.app/openapi.json (OpenAPI 3.1). Catalog: https://rockfieldpharmacy.vercel.app/.well-known/api-catalog.

## MCP server

Streamable HTTP at https://rockfieldpharmacy.vercel.app/api/mcp (also reachable at https://rockfieldpharmacy.vercel.app/.well-known/mcp), no authentication, stateless.

Tools: `get_pharmacy_details`, `list_services`, `list_common_conditions`, `get_common_condition`, `get_prices`, `check_consultation_availability`, `read_page_as_markdown`.

Server card: https://rockfieldpharmacy.vercel.app/.well-known/mcp/server-card.json

## Conventions

- Errors are RFC 9457 problem documents (`application/problem+json`) with a stable `code` and a `resolution` field.
- Rate limits are advertised in `RateLimit-*` response headers: 120 requests/minute per client, 30/minute for availability and MCP.
- List endpoints take `?limit` and `?offset`, or `?cursor` with the `nextCursor` from the previous page, and return a `pagination` object.
- `?fields=a,b` on a single-object endpoint returns only those top-level fields; `?service=<id>` filters the price list to one line.
- Every response carries `API-Version` and a `Link` header pointing at the deprecation policy below.
- Read-only by design: booking a consultation, submitting a prescription and paying all need the patient's own details and consent.

## Trying it out

No sandbox key or test account is needed. Every endpoint is read-only, returns no personal data, and can be called directly — nothing here can create, charge or change anything, so the live API is the sandbox.

Base URL: https://rockfieldpharmacy.vercel.app/api/v1

## Versioning

Breaking changes ship as a new path prefix (/api/v2); /api/v1 keeps its shape. New optional fields may be added to existing responses, so parse leniently. A version stays available for at least 6 months after its successor ships, and a removal date is announced in the `Deprecation` and `Sunset` response headers first.

## Deprecation policy

Nothing in /api/v1 is deprecated today and no sunset date is set (`deprecated: false`, `sunset: null`). When that changes you will see it in the response itself, not in a changelog you have to watch:

- A deprecated endpoint sends a `Deprecation` header carrying the date it was deprecated (RFC 9745).
- A removal date, once fixed, is sent in a `Sunset` header (RFC 8594) at least 180 days ahead.
- Its replacement is named in a `Link` header with `rel="successor-version"`.
- The operation is marked `deprecated: true` in /openapi.json before any of the above changes.

A removal date is announced at least 180 days ahead. The machine-readable copy of this policy is the `deprecation` object in https://rockfieldpharmacy.vercel.app/api/v1 and `info.x-deprecation-policy` in https://rockfieldpharmacy.vercel.app/openapi.json.

One endpoint already shows the mechanism working: `GET /api/calendly/availability` predates this API and answers with a `Deprecation` header (RFC 9745) and a `Link` naming `https://rockfieldpharmacy.vercel.app/api/v1/availability` as its successor.

## Contact Rockfield Pharmacy

- Phone: +353 1 296 7340
- Email: rockfieldpharmacy@gmail.com
- Address: Unit 2 Rockfield Central, Balally Luas Stop, Dundrum, D16K295, Ireland
- Opening hours: Mon – Fri: 09:00 – 19:00; Saturday: 10:00 – 16:00; Sunday: Closed (bank holiday hours may vary)
- PSI registration number: 7842-X (verify at https://registrations.thepsi.ie/search-isl/?search=*rockfieldpharmacy.ie*)

---

- Canonical HTML page: https://rockfieldpharmacy.vercel.app/developers
- This page as markdown: https://rockfieldpharmacy.vercel.app/developers.md — or request https://rockfieldpharmacy.vercel.app/developers with `Accept: text/markdown`
- Site index for agents: https://rockfieldpharmacy.vercel.app/llms.txt
- Every page as one markdown file: https://rockfieldpharmacy.vercel.app/llms-full.txt
- All canonical URLs: https://rockfieldpharmacy.vercel.app/sitemap.xml
- Developer and agent resources: https://rockfieldpharmacy.vercel.app/for-agents