External API

Alma

Two partners; two goals

Partner a

Large insurance company

Net new partnership

Exposure to client funnel

partner b

Smaller insurance partner

Pre-existing manual partnership

Urgent need to automate process

〞

FHIR (Fast Healthcare Interoperability Resources) is designed to enable information exchange to support the provision of healthcare in a wide variety of settings... to enable the provision of integrated healthcare across a wide range of teams and organizations.

– FHIR documentation

  • GET /practioners

  • GET /practioners/:id/availableSlots

  • POST /appointments

  • GET /appointments/:id

proposed Endpoints

{
  "resourceType" : "Practitioner",
  "identifier" : [{ Identifier }],
  "active" : <boolean>, // Whether this practitioner's record is in active use
  "name" : [{ HumanName }], // The name(s) associated with the practitioner
  "telecom" : [{ ContactPoint }], // A contact detail for the practitioner
  "gender" : "<code>", // male | female | other | unknown
  "birthDate" : "<date>", // The date  on which the practitioner was born
  "address" : [{ Address }], // Address(es) of the practitioner
  "photo" : [{ Attachment }], // Image of the person
  "qualification" : [{ // certifications, accreditations, licenses, training, etc. 
    "identifier" : [{ Identifier }],
    "period" : { Period }, // Period during which the qualification is valid
    "issuer" : { Reference(Organization) }
  }],
  "communication" : [{ // A language which may be used to communicate with the practitioner
    "language" : { CodeableConcept },
    "preferred" : <boolean> // Language preference indicator
  }]
}

  • Patient endpoint

  • Schedule endpoint

  • Asynchronous Bulk Data Request Pattern

  • Strict location data model

Complexity from partner a

  • Led to a gain of 9% on appointment bookings

  • Reduced our CAC by 8%

  • Led to increase of 2000 zero-cost appointments per month, which contributed to $8.5 million in ARR

  • Reduced the number of operations people needed to facilitate the manual booking with Partner B

  • New team created to further support expansion of API and other partnerships

  • Tech lead promoted

Impact

Alma External API

By borisonr

Made with Slides.com

Alma External API

  • 8

More from borisonr