Changelog
This page tracks notable, user-facing changes across the Bloody Good Tests platform — the REST API and webhooks, the practitioner portal, and the consumer website. Entries are listed newest-first.
Each entry is tagged with the area it affects:
| Tag | Area |
|---|---|
| API | The REST API. Where relevant, the affected version is noted (e.g. API · v1.1.0). |
| Webhooks | Webhook events and delivery. |
| Portal | The practitioner portal — ordering, results, organisation & member management, branding. |
| Website | The consumer website — buying tests, viewing results, importing your own results. |
The API is versioned via the Accept header (see
API Versioning). Backwards-incompatible changes to
existing response shapes are introduced behind a new version; additive fields
may appear on an existing version without a version bump. For the full,
always-current contract, see the REST API reference and the
interactive Swagger Documentation.
July 2026
- API · v1.1.0 — Medicare ordering.
POST /v1/referralsacceptsmedicareTeststo order tests under Medicare with the practitioner's provider number, producing a separate Medicare referral. Every referral response carries amedicareboolean. Ordering a test under Medicare is not a guarantee that the patient pays nothing — eligibility and any gap or full fee are decided by the collecting laboratory at the time of collection. See Medicare ordering. - API · v1.1.0 —
routingMessageon Medicare referrals. The Medicare referral returned from Create now carries a plain-language summary of whether (and from which labs) the practitioner's results will route back to them automatically. Advisory only — it never blocks the order.nullon commercial referrals and on all other endpoints. See the response fields. - Portal — Roles and permissions. Organisations now control member access through roles built from individual capabilities, with built-in Owner / Admin / Support / Read-only roles and support for custom ones (Settings → Roles). Medicare ordering is opt-in — no built-in role grants it; create a role with the Order with Medicare provider number capability. Existing members kept the access they had. Note this governs people, not API credentials — an API key authenticates as the organisation and is not limited by any member's roles. See Roles & Permissions.
- Portal — Medicare result routing. Notify each pathology laboratory that a practitioner is ordering through BGT, so their Medicare results route back to the right organisation (Settings → Result routing).
- API · v1.1.0 · Portal — Medicare ordering is now live in
production. After rolling out in non-production environments, Medicare
ordering via
POST /v1/referrals(v1.1.0+) is generally available to all organisations. No API changes are required — order under a registered provider number as documented. See Medicare ordering. - API · v1.1.0 · Portal — Medicare provider signatures. Ordering-provider signatures can now be captured when registering a Medicare provider (Settings → Provider Numbers) — a prerequisite for Medicare ordering. The signature dialog was redesigned with a PDF preview.
- Website — The Import results (bring-your-own results) action moved to the site header and the PDF preview was fixed, making it easier to upload historical lab results.
- Website —
/buylinks now route to the dedicated consumer app automatically, plus general buy-page fixes. - Portal · Website — One-click cross-app sign-in between the practitioner and consumer apps.
June 2026
-
API · v1.1.0 · Portal — Medicare ordering. Order Medicare-billed pathology tests alongside commercial tests via
POST /v1/referrals, under a registered provider number. The request returns an array of referrals (one commercial, one Medicare) and the patient receives a single email with both referral PDFs. In the portal, provider-address and clinical-notes capture were added and prices are hidden for Medicare items. See Medicare ordering. -
API — Referral editing & reissue. Update a referral's patient details and metadata via
PATCH /v1/referrals/{uuid}; the referral PDF is regenerated automatically. -
Website · Portal — Bring Your Own (BYO) lab results. Customers can upload, review and confirm their own historical lab results, folded into the Results page.
-
Website — A dedicated consumer app launched, with a personal mode and seamless cross-app session transfer from the practitioner app.
-
API · v1.0.0 · Portal — Address handling improved:
postCodeis accepted and returned consistently as a string,addressLine2is optional, and state is captured across verification, settings and payment. -
API · v1.0.0 — Referral responses are now resilient to imperfect stored data — returned as stored rather than failing the request.
-
Portal — Results status “Pending” renamed to “Lab Processing” and turnaround-time estimates removed; reworked profile verification flow; Knowledge Base link added to the sidebar; branding settings now show image-requirement hints.
-
Website — Account credits are now handled at checkout.
May 2026
- API · v1.0.0 · Portal · Website — Lipid risk-target ranges. Result
biomarkers now expose
additionalRangesfor cardiovascular/lipid risk targets (e.g. high-risk cholesterol) alongside the standard reference range, and these are presented correctly to users. - Portal — White-label branding support, letting organisations theme their experience.
- Portal — Organisation webhook configuration and member management are now generally available.
- Website · Portal — Collection-centre map/finder UX improvements.
- API — Added a machine-readable
GET /llms.txtAPI description for LLM/agent tooling, and corrected the Swagger docs URL.
April 2026
- API · v1.0.0 — New
PATCH /v1/referrals/{uuid}endpoint to update a referral. - API · v1.0.0 — Results now include
resultAttachment, a signed URL to the result PDF. - API · v1.0.0 — Referrals and results now include
productIdandproductName. - API · v1.0.0 · Portal · Website — Female sex-hormone biomarkers now
expose cycle-phase reference ranges via
additionalRanges. - API · v1.0.0 — Partner discount information is now returned via the API.
- API (staging) —
PUT /v1/referrals/{uuid}generates dummy results so you can exercise the results flow and webhooks end-to-end without a real lab. See Simulate Results. - Portal — Ability to store/import results that aren't tied to a referral (foundation for BYO).
- Website — Support redirecting back to your site when a purchase completes.
March 2026
- Portal — Mobile-responsive Referrals, Results, Members and Invitations tables.
- Portal — Extracted-PDF view for results parsed from lab (HL7) messages.
- Portal — Staged results now show the referring and consulting doctor and can be sorted by pending biomarkers.
- Portal — Organisation support email can now be configured.
- Website — Minimum-age restriction enforced at ordering.
February 2026
- Portal — New app shell & navigation redesign.
- Portal — Organisation member management — invite members and manage roles with an enforced role hierarchy.
- API · v1.0.0 · Portal — Referral responses now include the full
personobject (patient name, contact, DOB, gender, address). - API · v1.0.0 · Portal — Result biomarkers now include
sampleType(e.g.serum,whole-blood). - API · v1.0.0 · Portal — Fasting status captured and surfaced on results.
- Portal · Website — Results page can auto-show optimal ranges.
- Webhooks — Delivery de-duplication fixed and an event UUID added for idempotency (see Idempotency).
January 2026
- Website — New buy pages with customer Stripe details and a revamped checkout, plus an hCaptcha challenge on the buy page.
- Portal — Organisation-level discounts support.
- API · v1.0.0 — Referral responses now include
referralType(e.g.blood).