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 21 more developer resources.

🌐 Visit website 📡 Source on GitHub
38.5/100 thin ▬ flat Agent 40/100 agent aware Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessSelf serve
1 APIs 1 MCP Servers
CompanyHealthHealthcareElectronic Health RecordsPersonal Health RecordFHIRInteroperabilityNHSPatient DataMedical Records

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 38.5/100 · thin
Contract Quality 0.0 / 25
Developer Ergonomics 11.3 / 20
Commercial Clarity 6.3 / 20
Operational Transparency 6.2 / 13
Governance 0.0 / 12
Discoverability 9.3 / 10
Agent readiness — 40/100 · agent aware
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 15
MCP Server 12 / 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 4 / 4
Consent & Bot Identity 3 / 3
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.

patients-know-best-mcp.yml

MCP SERVER

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Patients Know Best Authentication

oauth2 · 1 scheme

SECURITY

Patients Know Best Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Patients Know Best Vulnerability Disclosure

security.txt · contact published

SECURITY

Resources

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 SignUp
SignUp
 Login
Login

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
MCPServer
 LLMsTxt
LLMsTxt
 WellKnown
WellKnown
 AgentSkill
AgentSkill

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Conventions
Conventions
 Conformance
Conformance
 ErrorCatalog
ErrorCatalog
 Lifecycle
Lifecycle
 DataModel
DataModel

Access & Security 6

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication
 Compliance
Compliance
 SecurityTxt
SecurityTxt
 VulnerabilityDisclosure
VulnerabilityDisclosure
 Security
Security

Operate 4

Status, limits, changes, and where to get help

Roadmap
Roadmap
 Support
Support
 StatusPage
StatusPage
 ChangeLog
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)

apis.yml Raw ↑ 
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.20'
created: '2026-07-17'
modified: '2026-07-20'
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