Swifty API Overview

Domains and Tenants

SwiftyRx is multi-tenant, with each tenant corresponding to a virtual pharmacy. In each environment, there is a bootstrap tenant that is used for initial authentication and to get a list of tenants that the logged in account has access to. Each tenant has the concept of a slug that is used as the first part of the domain in the subsequent API calls. For example, in our development environment (which runs on the swiftyrx.dev domain), the bootstrap url is https://bootstrap.swiftyrx.dev. One of the tenants for demo purposes is Acme Pharmacy which has a slug of acme. As such, to access the Acme tenant via API, you would then use the domain acme.swiftyrx.dev.

OAuth API

We are still working on publishing this out to a hosted server. However, you can download the current openapi_auth.yaml file for further review.

With this API, you can perform a login with a username and password and receive a Bearer token that can then be used to interact with the main API.

Main API

The main API Swagger UI can be viewed for any tenant at the /api/ui/ root of the main domain. For example, you can look at the latest API documentation for our Development Environment at Main Swagger API.

With this API, you can send in patient registration information, search for prescriptions, search for patients, search for medications, validate a US address, get the details for a patient, get the details for a prescription, search for providers and pharmacies, etc.