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