Semble

Semble is a London-headquartered (7 Bell Yard, London, WC2A 2JR) cloud clinical and practice-management platform for United Kingdom private and independent healthcare providers, from solo clinicians to corporate and enterprise clinics. Its modular EHR unifies patient records, appointment scheduling and online booking, video consultations, e-prescribing, pathology/lab ordering, clinical documentation, invoicing and payments (Semble Pay) and patient communications. Semble exposes a single open, secure public GraphQL API at https://open.semble.io/graphql, available to Semble clinics at no extra cost, letting developers read and write patients, bookings, availability, consultations, clinical pathways, prescriptions, labs, invoices, tasks, forms, questionnaires and webhooks. Authentication is API-key / token based (an x-token header carrying a role-scoped token that expires after 12 hours) rather than SMART-on-FHIR; the API is GraphQL-native and does not publish an HL7 FHIR CapabilityStatement or a downloadable OpenAPI. Semble emphasises GDPR compliance and UK healthcare security standards, with data encrypted in transit and at rest.

Semble publishes 6 APIs on the APIs.io network. Tagged areas include Healthcare, United Kingdom, EHR, Practice Management, and GraphQL.

The Semble catalog on APIs.io includes 1 event-driven AsyncAPI specification.

Semble’s developer surface includes authentication, changelog, documentation, API reference, getting-started guide, engineering blog, support, and 19 more developer resources.

49.4/100 developing ▬ flat Agent 35/100 agent aware Full breakdown ↓
scored 2026-07-27 · rubric v0.5
6 APIs
HealthcareUnited KingdomEHRPractice ManagementGraphQLPatient RecordsSchedulinge-PrescribingInteroperabilityDigital Health

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 49.4/100 · developing
Contract Quality 5.7 / 25
Developer Ergonomics 11.7 / 20
Commercial Clarity 10.0 / 20
Operational Transparency 9.2 / 13
Governance 0.0 / 12
Discoverability 10.0 / 10
Agent readiness — 35/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 7 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 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/semble: 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 6

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

Semble Patients API

GraphQL queries and mutations over the Semble patient record — patients, demographics, phone numbers, relationships, labels, memberships, access groups, allergy records, free-te...

Semble Scheduling & Bookings API

GraphQL surface for appointments and scheduling — bookings, bookings-by-id, availabilities, availability rules, availability settings, availability slots, online booking configu...

Semble Clinical API

GraphQL surface for clinical documentation and care pathways — consultations, clinical pathways, clinical reports, episodes and episode types, letters, working diagnoses, diagno...

Semble Prescriptions & Labs API

GraphQL surface for e-prescribing and diagnostics — prescriptions, repeat prescriptions and lab / pathology orders and results, integrated with Semble's pharmacy and lab partner...

Semble Billing & Payments API

GraphQL surface for practice finances — invoices, invoice payments and line items, account statements, products, price profiles, price rules and price adjustment rules, and Semb...

Semble Practice & Platform API

GraphQL surface for practice administration and platform integration — practice details, users, contacts, tasks, labels, patient documents, practice template documents, integrat...

Rate Limits 1

Documented rate limits and quota policies.

Semble Rate Limits

1 limits

RATE LIMITS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Semble Webhooks

ASYNCAPI

Security Posture 3

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

Semble Authentication

apiKey · 1 scheme

SECURITY

Semble Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Semble Trust Center

ISO 27001, PCI DSS, GDPR

SECURITY

Resources

Get Started 3

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Access & Security 6

Authentication, authorization, and security posture

Operate 4

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: semble
url: https://raw.githubusercontent.com/api-evangelist/semble/refs/heads/main/apis.yml
name: Semble
kind: company
description: Semble is a London-headquartered (7 Bell Yard, London, WC2A 2JR) cloud clinical and practice-management platform
  for United Kingdom private and independent healthcare providers, from solo clinicians to corporate and enterprise clinics.
  Its modular EHR unifies patient records, appointment scheduling and online booking, video consultations, e-prescribing,
  pathology/lab ordering, clinical documentation, invoicing and payments (Semble Pay) and patient communications. Semble exposes
  a single open, secure public GraphQL API at https://open.semble.io/graphql, available to Semble clinics at no extra cost,
  letting developers read and write patients, bookings, availability, consultations, clinical pathways, prescriptions, labs,
  invoices, tasks, forms, questionnaires and webhooks. Authentication is API-key / token based (an x-token header carrying
  a role-scoped token that expires after 12 hours) rather than SMART-on-FHIR; the API is GraphQL-native and does not publish
  an HL7 FHIR CapabilityStatement or a downloadable OpenAPI. Semble emphasises GDPR compliance and UK healthcare security
  standards, with data encrypted in transit and at rest.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Healthcare
- United Kingdom
- EHR
- Practice Management
- GraphQL
- Patient Records
- Scheduling
- e-Prescribing
- Interoperability
- Digital Health
created: '2026-07-24'
modified: '2026-07-24'
specificationVersion: '0.19'
apis:
- aid: semble:semble-patients-api
  name: Semble Patients API
  description: GraphQL queries and mutations over the Semble patient record — patients, demographics, phone numbers, relationships,
    labels, memberships, access groups, allergy records, free-text records, patient documents and patient communications.
    Part of the single Semble public GraphQL API.
  humanURL: https://docs.semble.io/docs/API/queries/patients/
  baseURL: https://open.semble.io/graphql
  tags:
  - Patients
  - Patient Records
  - Healthcare
  properties:
  - type: Documentation
    url: https://docs.semble.io/
  - type: APIReference
    url: https://docs.semble.io/docs/API/
  - type: GraphQL
    url: https://docs.semble.io/docs/API/queries/patients/
  - type: Authentication
    url: https://docs.semble.io/docs/authentication/
- aid: semble:semble-scheduling-api
  name: Semble Scheduling & Bookings API
  description: GraphQL surface for appointments and scheduling — bookings, bookings-by-id, availabilities, availability rules,
    availability settings, availability slots, online booking configurations, out-of-office bookings and terminal/online booking
    payments.
  humanURL: https://docs.semble.io/docs/API/queries/bookings/
  baseURL: https://open.semble.io/graphql
  tags:
  - Scheduling
  - Bookings
  - Appointments
  properties:
  - type: Documentation
    url: https://docs.semble.io/
  - type: APIReference
    url: https://docs.semble.io/docs/API/
  - type: GraphQL
    url: https://docs.semble.io/docs/API/queries/bookings/
  - type: Authentication
    url: https://docs.semble.io/docs/authentication/
- aid: semble:semble-clinical-api
  name: Semble Clinical API
  description: GraphQL surface for clinical documentation and care pathways — consultations, clinical pathways, clinical reports,
    episodes and episode types, letters, working diagnoses, diagnosis codes, forms and questionnaires.
  humanURL: https://docs.semble.io/docs/API/queries/consultations/
  baseURL: https://open.semble.io/graphql
  tags:
  - Clinical
  - Consultations
  - Documentation
  properties:
  - type: Documentation
    url: https://docs.semble.io/
  - type: APIReference
    url: https://docs.semble.io/docs/API/
  - type: GraphQL
    url: https://docs.semble.io/docs/API/queries/consultations/
  - type: Authentication
    url: https://docs.semble.io/docs/authentication/
- aid: semble:semble-prescriptions-labs-api
  name: Semble Prescriptions & Labs API
  description: GraphQL surface for e-prescribing and diagnostics — prescriptions, repeat prescriptions and lab / pathology
    orders and results, integrated with Semble's pharmacy and lab partner network.
  humanURL: https://docs.semble.io/docs/API/queries/prescriptions/
  baseURL: https://open.semble.io/graphql
  tags:
  - e-Prescribing
  - Labs
  - Pathology
  properties:
  - type: Documentation
    url: https://docs.semble.io/
  - type: APIReference
    url: https://docs.semble.io/docs/API/
  - type: GraphQL
    url: https://docs.semble.io/docs/API/queries/prescriptions/
  - type: Authentication
    url: https://docs.semble.io/docs/authentication/
- aid: semble:semble-billing-payments-api
  name: Semble Billing & Payments API
  description: GraphQL surface for practice finances — invoices, invoice payments and line items, account statements, products,
    price profiles, price rules and price adjustment rules, and Semble Pay payment terminals / readers.
  humanURL: https://docs.semble.io/docs/API/queries/invoices/
  baseURL: https://open.semble.io/graphql
  tags:
  - Billing
  - Payments
  - Invoicing
  properties:
  - type: Documentation
    url: https://docs.semble.io/
  - type: APIReference
    url: https://docs.semble.io/docs/API/
  - type: GraphQL
    url: https://docs.semble.io/docs/API/queries/invoices/
  - type: Authentication
    url: https://docs.semble.io/docs/authentication/
- aid: semble:semble-practice-platform-api
  name: Semble Practice & Platform API
  description: GraphQL surface for practice administration and platform integration — practice details, users, contacts, tasks,
    labels, patient documents, practice template documents, integration tokens and webhooks for event-driven integrations.
  humanURL: https://docs.semble.io/docs/API/queries/webhooks/
  baseURL: https://open.semble.io/graphql
  tags:
  - Practice Management
  - Webhooks
  - Platform
  properties:
  - type: Documentation
    url: https://docs.semble.io/
  - type: APIReference
    url: https://docs.semble.io/docs/API/
  - type: GraphQL
    url: https://docs.semble.io/docs/API/queries/webhooks/
  - type: Authentication
    url: https://docs.semble.io/docs/authentication/
common:
- type: TrustCenter
  url: security/semble-trust-center.yml
- type: DomainSecurity
  url: security/semble-domain-security.yml
- type: Compliance
  url: https://trust.semble.io/
- type: Conformance
  url: conformance/semble-conformance.yml
- type: Authentication
  url: authentication/semble-authentication.yml
- type: Conventions
  url: conventions/semble-conventions.yml
- type: ErrorCatalog
  url: errors/semble-error-codes.yml
- type: RateLimits
  url: rate-limits/semble-rate-limits.yml
- type: Lifecycle
  url: lifecycle/semble-lifecycle.yml
- type: Webhooks
  url: asyncapi/semble-webhooks.yml
- type: AgentSkill
  url: skills/_index.yml
- type: LLMsTxt
  url: llms/semble-llms.txt
- type: ChangeLog
  url: https://docs.semble.io/docs/release-notes/
- type: Website
  url: https://www.semble.io/
- type: DeveloperPortal
  url: https://docs.semble.io/
- type: Documentation
  url: https://docs.semble.io/
- type: APIReference
  url: https://docs.semble.io/docs/API/
- type: GettingStarted
  url: https://help.semble.io/api-access
- type: Authentication
  url: https://docs.semble.io/docs/authentication/
- type: StatusPage
  url: https://status.semble.io/
- type: Security
  url: https://trust.semble.io/
- type: Blog
  url: https://www.semble.io/blog
- type: Support
  url: https://help.semble.io/
- type: SignUp
  url: https://www.semble.io/book-a-demo
- type: TermsOfService
  url: https://www.semble.io/terms-of-service
- type: PrivacyPolicy
  url: https://www.semble.io/privacy-policy
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com