Patients Know Best

Patients Know Best (PKB) is a UK health-technology company operating what it describes as the world's largest personal health record, with more than seven million registered patients across the NHS and other health systems. The platform lets patients hold, view and share their medical records, messages, test results, care plans and questionnaires with clinicians and carers across web, mobile and the NHS App. For integrators, PKB publishes a HL7 FHIR STU3 (3.0.2) API — the "Facade" FHIR server at my.patientsknowbest.com/fhir — that conforms to the NHS CareConnect profiles and exposes patient demographics, documents, observations, appointments, consent, questionnaires and read receipts, secured with OAuth 2.0 client-credentials. PKB was surfaced as a Seedcamp portfolio company and enriched into the API Evangelist network.

Patients Know Best publishes 1 API on the APIs.io network. Tagged areas include Company, Health, Healthcare, Electronic Health Records, and Personal Health Record.

Patients Know Best’s developer surface includes documentation, API reference, support, engineering blog, signup flow, changelog, authentication, and 22 more developer resources.

🌐 Visit website 📡 Source on GitHub

45.4/100 developing ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0

AccessSelf serve

1 APIs 1 MCP Servers

CompanyHealthHealthcareElectronic Health RecordsPersonal Health RecordFHIRInteroperabilityNHSPatient DataMedical Records

Kin Score

Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0

Composite quality — 45.4/100 · developing

Contract Quality 7.7 / 21

Developer Ergonomics 8.4 / 17

Access Clarity 5.4 / 17

Operational Transparency 5.2 / 11

Contract Governance 1.9 / 10

Discoverability 7.4 / 9

Regulatory Posture 6.0 / 15

Agent readiness — 31/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 0 / 10

Documented Reversibility 0 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 0 / 7

Typed Event Surface 0 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 3 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Regulatory Posture applies to this provider. Its tags matched the Health regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/patients-know-best: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 1

Individual APIs this provider publishes, each with its own machine-readable definition.

PKB Facade FHIR API

HL7 FHIR STU3 (3.0.2) "Facade" server exposing Patients Know Best personal health record data — Patient, Appointment, Communication, Consent, DiagnosticReport, DocumentReference...

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Get Started 4

Portal, sign-up, and the first successful call

DeveloperPortal

DeveloperPortal

SignUp

SignUp

Login

Sandbox

Sandbox

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

MCPServer

LLMsTxt

WellKnown

AgentSkill

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Conventions

Conformance

ErrorCatalog

Lifecycle

DataModel

Access & Security 6

Authentication, authorization, and security posture

DomainSecurity

Authentication

Compliance

SecurityTxt

VulnerabilityDisclosure

VulnerabilityDisclosure

Security

Security

Operate 4

Status, limits, changes, and where to get help

Roadmap

Support

StatusPage

ChangeLog

Commercial 1

Pricing, plans, and the legal terms of use

PrivacyPolicy

PrivacyPolicy

Company 3

The organization behind the API

Website

Website

Blog

Blog

Partners

Partners

Source (apis.yml)

aid: patients-know-best
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/patients-know-best.png
name: Patients Know Best
description: Patients Know Best (PKB) is a UK health-technology company operating what it describes as the world's largest
  personal health record, with more than seven million registered patients across the NHS and other health systems. The platform
  lets patients hold, view and share their medical records, messages, test results, care plans and questionnaires with clinicians
  and carers across web, mobile and the NHS App. For integrators, PKB publishes a HL7 FHIR STU3 (3.0.2) API — the "Facade"
  FHIR server at my.patientsknowbest.com/fhir — that conforms to the NHS CareConnect profiles and exposes patient demographics,
  documents, observations, appointments, consent, questionnaires and read receipts, secured with OAuth 2.0 client-credentials.
  PKB was surfaced as a Seedcamp portfolio company and enriched into the API Evangelist network.
url: https://raw.githubusercontent.com/api-evangelist/patients-know-best/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- seedcamp
x-tier: profiled
x-tier-reason: has-fhir-api
specificationVersion: '0.23'
created: '2026-07-17'
modified: '2026-08-08'
x-enrichment:
  date: '2026-07-20'
  status: enriched
  artifacts_added: 15
  pass: local-v1
tags:
- Company
- Health
- Healthcare
- Electronic Health Records
- Personal Health Record
- FHIR
- Interoperability
- NHS
- Patient Data
- Medical Records
apis:
- name: PKB Facade FHIR API
  description: HL7 FHIR STU3 (3.0.2) "Facade" server exposing Patients Know Best personal health record data — Patient, Appointment,
    Communication, Consent, DiagnosticReport, DocumentReference, Encounter, Observation, Questionnaire and QuestionnaireResponse
    resources — conforming to NHS CareConnect profiles, plus custom operations for purview, read-receipt queries and invitation-token
    generation. Secured with OAuth 2.0 client credentials.
  humanURL: https://wiki.patientsknowbest.com/space/api/3363602489/FHIR%C2%AE+APIs
  baseURL: https://my.patientsknowbest.com/fhir
  tags:
  - FHIR
  - Health
  - Electronic Health Records
  - NHS
  - Interoperability
  properties:
  - type: FHIR
    url: fhir/patients-know-best-facade-capabilitystatement.json
  - type: CapabilityStatement
    url: fhir/patients-know-best-facade-capabilitystatement.json
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: DomainSecurity
  url: security/patients-know-best-domain-security.yml
- type: Website
  url: https://patientsknowbest.com
- type: DeveloperPortal
  url: https://wiki.patientsknowbest.com/space/api
- type: Documentation
  url: https://wiki.patientsknowbest.com/space/api/3363602489/FHIR%C2%AE+APIs
- type: APIReference
  url: https://pkbdev.atlassian.net/wiki/spaces/api/pages/3363602541/FHIR+Conformance
- type: Roadmap
  url: https://wiki.patientsknowbest.com/space/api
- type: Support
  url: https://manual.patientsknowbest.com/
- type: Blog
  url: https://blog.patientsknowbest.com/
- type: PrivacyPolicy
  url: https://patientsknowbest.com/privacy-statement/
- type: SignUp
  url: https://patientsknowbest.com/register/
- type: Login
  url: https://my.patientsknowbest.com/
- type: StatusPage
  url: https://www.pkbstatus.com/
- type: ChangeLog
  url: https://wiki.patientsknowbest.com/space/REL
- type: Partners
  url: https://patientsknowbest.com/partners/
- type: Authentication
  url: authentication/patients-know-best-authentication.yml
- type: Conventions
  url: conventions/patients-know-best-conventions.yml
- type: Conformance
  url: conformance/patients-know-best-conformance.yml
- type: Compliance
  url: https://patientsknowbest.com
- type: ErrorCatalog
  url: errors/patients-know-best-problem-types.yml
- type: Lifecycle
  url: lifecycle/patients-know-best-lifecycle.yml
- type: DataModel
  url: data-model/patients-know-best-data-model.yml
- type: MCPServer
  url: mcp/patients-know-best-mcp.yml
- type: LLMsTxt
  url: llms/patients-know-best-llms.txt
- type: WellKnown
  url: well-known/patients-know-best-well-known.yml
- type: SecurityTxt
  url: well-known/patients-know-best-security.txt
- type: VulnerabilityDisclosure
  url: security/patients-know-best-vulnerability-disclosure.yml
- type: Security
  url: https://my.patientsknowbest.com/.well-known/security.txt
- type: AgentSkill
  url: skills/_index.yml
- type: Sandbox
  url: sandbox/patients-know-best-sandbox.yml
x-merged-from:
- patientsknowbest