Patients Know Best

Patients Know Best (PKB) operates one of the world's largest personal health record (PHR) platforms, giving over seven million patients a single lifelong medical record they own and control. The platform aggregates data from the NHS App, GP systems, hospitals, wearables and health-tech partners, and lets patients securely share it with clinicians and carers, manage care plans, message professionals and track symptoms. For interoperability PKB publishes a HL7 FHIR API (with a public FHIR Conformance / CapabilityStatement) secured with OAuth 2.0 following the SMART on FHIR pattern, alongside HL7 v2 messaging. Backed by Balderton Capital and added to the API Evangelist network from that VC portfolio.

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

Patients Know Best’s developer surface includes documentation, API reference, changelog, support, authentication, sandbox, and 10 more developer resources.

🌐 Visit website 📡 Source on GitHub
27.8/100 emerging ▬ flat Agent 17/100 agent aware Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessSelf serve
1 APIs
CompanyHealthcareHealth RecordsFHIRInteroperabilityPatient DataNHSHL7

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 27.8/100 · emerging
Contract Quality 0.0 / 25
Developer Ergonomics 9.1 / 20
Commercial Clarity 2.1 / 20
Operational Transparency 4.1 / 13
Governance 0.0 / 12
Discoverability 9.3 / 10
Agent readiness — 17/100 · agent aware
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 15
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 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 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/patientsknowbest: 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.

Patients Know Best FHIR API

HL7 FHIR RESTful API for reading and writing patient health records in the PKB personal health record, secured with OAuth 2.0 / SMART on FHIR.

Security Posture 2

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

Patientsknowbest Authentication

oauth2 · 1 scheme

SECURITY

Patientsknowbest Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Resources

Get Started 2

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 Sandbox
Sandbox

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

LLMsTxt
LLMsTxt

Design & Contract 4

Pagination, idempotency, versioning, errors, and events

Conformance
Conformance
 Conventions
Conventions
 ErrorCatalog
ErrorCatalog
 Lifecycle
Lifecycle

Access & Security 2

Authentication, authorization, and security posture

Authentication
Authentication
 DomainSecurity
DomainSecurity

Operate 3

Status, limits, changes, and where to get help

ChangeLog
ChangeLog
 StatusPage
StatusPage
 Support
Support

Commercial 1

Pricing, plans, and the legal terms of use

PrivacyPolicy
PrivacyPolicy

Company 1

The organization behind the API

Website
Website

Source (apis.yml)

apis.yml Raw ↑ 
aid: patientsknowbest
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/patientsknowbest.png
name: Patients Know Best
description: Patients Know Best (PKB) operates one of the world's largest personal health record (PHR) platforms, giving over
  seven million patients a single lifelong medical record they own and control. The platform aggregates data from the NHS
  App, GP systems, hospitals, wearables and health-tech partners, and lets patients securely share it with clinicians and
  carers, manage care plans, message professionals and track symptoms. For interoperability PKB publishes a HL7 FHIR API (with
  a public FHIR Conformance / CapabilityStatement) secured with OAuth 2.0 following the SMART on FHIR pattern, alongside HL7
  v2 messaging. Backed by Balderton Capital and added to the API Evangelist network from that VC portfolio.
url: https://raw.githubusercontent.com/api-evangelist/patientsknowbest/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- balderton-capital
x-tier: stub
x-tier-reason: portfolio-lead
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-20'
tags:
- Company
- Healthcare
- Health Records
- FHIR
- Interoperability
- Patient Data
- NHS
- HL7
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
apis:
- name: Patients Know Best FHIR API
  description: HL7 FHIR RESTful API for reading and writing patient health records in the PKB personal health record, secured
    with OAuth 2.0 / SMART on FHIR.
  humanURL: https://wiki.patientsknowbest.com/space/api
  baseURL: https://fhir.patientsknowbest.com/
  tags:
  - FHIR
  - Health Records
  - Interoperability
  properties:
  - type: APIReference
    url: https://fhir.patientsknowbest.com/metadata
  - type: Authentication
    url: authentication/patientsknowbest-authentication.yml
common:
- type: Website
  url: https://www.patientsknowbest.com/
- type: DeveloperPortal
  url: https://wiki.patientsknowbest.com/space/api
- type: Documentation
  url: https://wiki.patientsknowbest.com/space/MAN
- type: APIReference
  url: https://fhir.patientsknowbest.com/metadata
- type: ChangeLog
  url: https://wiki.patientsknowbest.com/space/REL
- type: StatusPage
  url: https://www.pkbstatus.com/
- type: Support
  url: https://patientsknowbest.com/contact-us/
- type: PrivacyPolicy
  url: https://patientsknowbest.com/privacy-statement/
- type: Authentication
  url: authentication/patientsknowbest-authentication.yml
- type: Conformance
  url: conformance/patientsknowbest-conformance.yml
- type: Conventions
  url: conventions/patientsknowbest-conventions.yml
- type: ErrorCatalog
  url: errors/patientsknowbest-problem-types.yml
- type: Lifecycle
  url: lifecycle/patientsknowbest-lifecycle.yml
- type: Sandbox
  url: sandbox/patientsknowbest-sandbox.yml
- type: LLMsTxt
  url: llms/patientsknowbest-llms.txt
- type: DomainSecurity
  url: security/patientsknowbest-domain-security.yml
x-enrichment:
  date: '2026-07-20'
  status: enriched
  artifacts_added: 8
  pass: local-v1