# RxBridge API

> RxBridge is a real-time e-prescribing bridge between provider (prescriber) organizations and pharmacy organizations. This is the public partner API under /api/v1 (version 1.0.0). Human-readable docs: https://rx-bridge.cofabri.com/docs/api. Machine-readable spec: https://rx-bridge.cofabri.com/openapi.json.

Base URL: https://rx-bridge.cofabri.com/api/v1

Auth: send an organization API key as `Authorization: Bearer <key>` or `x-api-key: <key>` (keys are prefixed `rxb_`).

## Contracts
- POST   /api/v1/contracts — Request a contract with a pharmacy
- GET    /api/v1/contracts — List contracts for the caller's organization
- PATCH  /api/v1/contracts/{id} — Accept, reject, or terminate a contract
- GET    /api/v1/contracts/{id} — Get a single contract

## Organization
- GET    /api/v1/me/organization — Get the API key's own organization

## Medications
- GET    /api/v1/medications — List medications available at accessible pharmacies

## Onboarding
- PATCH  /api/v1/onboarding/licenses — Update an existing prescriber's licenses and/or DEA registration
- GET    /api/v1/onboarding/licenses — Get a prescriber's licenses and DEA registration
- POST   /api/v1/onboarding/prescriber — Onboard (create or update) a prescriber in one call
- GET    /api/v1/onboarding/prescriber — Get the organization's prescribers and their onboarding status
- POST   /api/v1/onboarding/sessions — Create a hosted onboarding session for a prescriber
- GET    /api/v1/onboarding/sessions/{id} — Get a hosted onboarding session
- DELETE /api/v1/onboarding/sessions/{id} — Cancel a hosted onboarding session

## Pharmacies
- GET    /api/v1/pharmacies — Search pharmacies
- GET    /api/v1/pharmacies/recommend — Recommend a pharmacy for a patient

## Pricing
- POST   /api/v1/pricing/estimate — Estimate provider fee and/or pharmacy commission

## Scripts
- POST   /api/v1/scripts — Create a script
- GET    /api/v1/scripts — List scripts
- GET    /api/v1/scripts/{id} — Get a single script
- GET    /api/v1/scripts/{id}/events — List a script's timeline events
- GET    /api/v1/scripts/{id}/shipment — Get shipment/tracking info for a script
- POST   /api/v1/scripts/{id}/shipment — Update shipment/tracking info for a script
- PATCH  /api/v1/scripts/{id}/status — Update a script's fulfillment status

## Webhooks
- POST   /api/v1/webhooks — Register a webhook endpoint
- GET    /api/v1/webhooks — List webhook endpoints
- GET    /api/v1/webhooks/{id} — Get a single webhook endpoint
- PATCH  /api/v1/webhooks/{id} — Update a webhook endpoint
- DELETE /api/v1/webhooks/{id} — Delete a webhook endpoint

Full request/response schemas: https://rx-bridge.cofabri.com/openapi.json