The InStockRx External API lets partners act on the InStockRx marketplace on behalf of pharmacies — creating, updating and cancelling marketplace listings, draft listings and cash offers, searching the marketplace, and managing the pharmacies in their group. Every request does two things:
  1. Authenticates with your API key.
  2. Names a pharmacy, by NPI, that you are acting for.
That second point is the shape of the whole API. You never act as yourself — you act on behalf of a pharmacy that is both an InStockRx user and has an established relationship with you.
This is v1, the version currently in production. A v2 with transaction support, webhooks and scoped keys is in testing; it will be documented here when it reaches general availability.

​
What you can do

Marketplace listings

Offer a bottle of medication for sale. Create, update while pending, and cancel.

Draft listings

Stage a listing before it goes live — useful when the bottle is known but the price isn’t set yet.

Cash offers

Offer to buy a medication at a stated price, with your own packaging requirements.

Groups & pharmacies

See which pharmacies you can act for, and add more by NPI.
Beyond those, the API returns transaction statistics for an NDC and retrieves the notifications InStockRx generates for pharmacy users.

​
Getting started

1

Request access

API keys are issued by InStockRx staff. Request one — it takes one email.
2

Make your first call

The quickstart lists the pharmacies in your group. It needs nothing but your key.
3

Build

Work through the API reference for the full endpoint surface.