Photon Health

Photon Health is a modern e-prescribing (eRx) platform that lets digital-health organizations create patients, write prescriptions, route orders to pharmacies, and manage fulfillment through a single GraphQL Clinical API. The platform pairs the API with embeddable Elements UI components, webhooks, and a transparent prescription marketplace for pharmacy price and fulfillment comparison.

6 APIs 0 Features
Healthe-PrescribingeRxPrescriptionsPharmacyGraphQL

APIs

Photon Health Patients API

GraphQL queries and mutations for creating and managing patients - demographics, sex and gender, contact details, allergies, medication history, addresses, and preferred pharmac...

Photon Health Prescriptions API

Write and manage prescriptions with dosing, dispense quantity, refills, days supply, instructions, diagnoses, and effective/expiration dates via prescription, prescriptions, cre...

Photon Health Orders API

Route prescriptions to pharmacies as orders with fills and delivery addresses, and track fulfillment state via order, orders, createOrder, updateOrder, cancelOrder, and the fill...

Photon Health Catalog & Medications API

Search the medication catalog and manage organization formularies and reusable prescription templates via medications, medicationConcepts, medicationStrengths, medicationForms, ...

Photon Health Pharmacies API

Search pharmacies by name, location, and fulfillment type (PICK_UP or MAIL_ORDER) and retrieve NPI, NCPDP, address, fax, and phone via the pharmacy and pharmacies queries.

Photon Health Webhooks API

Subscribe to signed webhook events to receive state changes for orders (photon:order:created and related) and prescriptions (photon:prescription:* events), typically used to tri...

Collections

GraphQL

Photon Health GraphQL API

GraphQL schema for the [Photon Health](https://www.photon.health) Clinical API — a modern

GRAPHQL

Pricing Plans

Rate Limits

Photon Health Rate Limits

2 limits

RATE LIMITS

FinOps

Resources

👥
GitHubOrganization
GitHubOrganization
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
Documentation
Documentation
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: Photon Health Clinical API
  version: '1.0'
  description: GraphQL Clinical API for Photon Health. All operations are POST requests to https://api.photon.health/graphql
    with an OAuth2 Bearer access token.
request:
  auth:
    type: bearer
    token: '{{accessToken}}'
items:
- info:
    name: Patients
    type: folder
  items:
  - info:
      name: List patients
      type: http
    http:
      method: POST
      url: https://api.photon.health/graphql
      body:
        type: json
        data: '{"query":"query { patients(first: 10) { id externalId name { full } dateOfBirth sex } }"}'
    docs: List the organization's patients via the patients query.
  - info:
      name: Get patient by id
      type: http
    http:
      method: POST
      url: https://api.photon.health/graphql
      body:
        type: json
        data: '{"query":"query GetPatient($id: ID!) { patient(id: $id) { id externalId name { full } allergies { allergen
          { name } } prescriptions { id state } } }","variables":{"id":"pat_01H..."}}'
    docs: Retrieve a single patient and related records via the patient query.
  - info:
      name: Create patient
      type: http
    http:
      method: POST
      url: https://api.photon.health/graphql
      body:
        type: json
        data: '{"query":"mutation CreatePatient($name: NameInput!) { createPatient(externalId: \"ext-1001\", name: $name,
          dateOfBirth: \"1990-12-10\", sex: FEMALE, email: \"ada@example.com\", phone: \"+12025550100\") { id externalId }
          }","variables":{"name":{"first":"Ada","last":"Lovelace"}}}'
    docs: Create a new patient via the createPatient mutation.
- info:
    name: Prescriptions
    type: folder
  items:
  - info:
      name: List prescriptions
      type: http
    http:
      method: POST
      url: https://api.photon.health/graphql
      body:
        type: json
        data: '{"query":"query Prescriptions($patientId: ID!) { prescriptions(filter: { patientId: $patientId }, first: 25)
          { id state treatment { name } refillsRemaining } }","variables":{"patientId":"pat_01H..."}}'
    docs: List prescriptions, optionally filtered by patient, prescriber, or state.
  - info:
      name: Create prescription
      type: http
    http:
      method: POST
      url: https://api.photon.health/graphql
      body:
        type: json
        data: '{"query":"mutation CreatePrescription($patientId: ID!, $medicationId: ID!) { createPrescription(patientId:
          $patientId, medicationId: $medicationId, dispenseQuantity: 30, dispenseUnit: \"Each\", fillsAllowed: 3, daysSupply:
          30, instructions: \"Take one tablet by mouth daily.\") { id state refillsAllowed } }","variables":{"patientId":"pat_01H...","medicationId":"med_01H..."}}'
    docs: Write a new prescription via the createPrescription mutation.
  - info:
      name: Cancel prescription
      type: http
    http:
      method: POST
      url: https://api.photon.health/graphql
      body:
        type: json
        data: '{"query":"mutation CancelPrescription($id: ID!) { cancelPrescription(id: $id) { id state } }","variables":{"id":"rx_01H..."}}'
    docs: Cancel an active prescription via the cancelPrescription mutation.
- info:
    name: Orders
    type: folder
  items:
  - info:
      name: Create order
      type: http
    http:
      method: POST
      url: https://api.photon.health/graphql
      body:
        type: json
        data: '{"query":"mutation CreateOrder($patientId: ID!, $fills: [FillInput!]!, $pharmacyId: ID) { createOrder(patientId:
          $patientId, fills: $fills, pharmacyId: $pharmacyId) { id state pharmacy { name } fills { id state } } }","variables":{"patientId":"pat_01H...","pharmacyId":"phr_01H...","fills":[{"prescriptionId":"rx_01H..."}]}}'
    docs: Route prescriptions to a pharmacy via the createOrder mutation.
  - info:
      name: Cancel order
      type: http
    http:
      method: POST
      url: https://api.photon.health/graphql
      body:
        type: json
        data: '{"query":"mutation CancelOrder($id: ID!) { cancelOrder(id: $id) { id state } }","variables":{"id":"ord_01H..."}}'
    docs: Cancel a mail-order order via the cancelOrder mutation.
- info:
    name: Catalog & Medications
    type: folder
  items:
  - info:
      name: Search medications
      type: http
    http:
      method: POST
      url: https://api.photon.health/graphql
      body:
        type: json
        data: '{"query":"query SearchMedications($name: String!) { medications(filter: { name: $name }, first: 10) { id name
          type strength form } }","variables":{"name":"lisinopril"}}'
    docs: Search the medication catalog via the medications query.
- info:
    name: Pharmacies
    type: folder
  items:
  - info:
      name: Search pharmacies
      type: http
    http:
      method: POST
      url: https://api.photon.health/graphql
      body:
        type: json
        data: '{"query":"query FindPharmacies($lat: Float!, $lng: Float!) { pharmacies(location: { latitude: $lat, longitude:
          $lng, radius: 25 }, type: PICK_UP, first: 10) { id name NPI NCPDP address { street1 city state postalCode } } }","variables":{"lat":40.7128,"lng":-74.006}}'
    docs: Search pharmacies by location and fulfillment type via the pharmacies query.
bundled: true