Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Medblocks Public Certificates API
version: 1.0.0
summary: Public read-only endpoints and machine-readable feeds published by medblocks.com.
description: 'This document describes only the endpoints that medblocks.com publishes for third-party and automated use. It is intentionally narrow: other routes under /api are internal to the medblocks.com frontend, are not versioned, and are not supported for external callers.
All endpoints listed here are unauthenticated, read-only, and safe to retry.'
contact:
name: Medblocks
url: https://medblocks.com/contact
email: content@medblocks.com
servers:
- url: https://medblocks.com
description: Production
tags:
- name: Certificates
description: Verify a training certificate issued by Medblocks.
paths:
/api/certificates/{id}:
get:
operationId: getCertificate
tags:
- Certificates
summary: Verify a Medblocks training certificate
description: Returns the details of a certificate issued for completing a Medblocks course. Use this to confirm that a certificate presented by a candidate is genuine. The human-readable equivalent is https://medblocks.com/certificates/{id}.
parameters:
- name: id
in: path
required: true
description: The certificate identifier, as printed on the certificate.
schema:
type: string
responses:
'200':
description: The certificate exists.
content:
application/json:
schema:
$ref: '#/components/schemas/Certificate'
'400':
description: No certificate identifier was supplied.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: No certificate exists with that identifier.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: The certificate could not be looked up.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
Error:
type: object
properties:
error:
type: string
description: A human-readable description of what went wrong.
required:
- error
Certificate:
type: object
properties:
course_name:
type:
- string
- 'null'
description: Title of the course the certificate was issued for.
examples:
- FHIR Bootcamp
user_name:
type:
- string
- 'null'
description: Name of the person the certificate was issued to.
completion_date:
type:
- string
- 'null'
format: date-time
description: When the course was completed.
date_created:
type:
- string
- 'null'
format: date-time
description: When the certificate record was created.
date_updated:
type:
- string
- 'null'
format: date-time
description: When the certificate record was last changed.
image:
type:
- string
- 'null'
description: Identifier of the certificate image, when one has been generated.