Skip to content

PharmaOne API

Connect POS systems, ERP connectors, n8n, WooCommerce/JTL plugins, and custom backends to PharmaOne Manager.

  • Authentication

    Exchange your organization API key for a scoped JWT.

    Auth guide

  • API Reference

    Full v2 route map — orders, inventory, products, reports, webhooks.

    Overview

  • Interactive API Explorer

    Try all endpoints in your browser with Swagger UI.

    Open Swagger

  • Inventory & stock

    Adjust stock, assign products to shops, sync from external systems.

    Inventory guide

  • Orders & order requests

    Upsert orders directly or submit requests for staff review.

    Orders

  • External Telemedicine Connector

    Shop-scoped order requests for telemedicine partners (URL + API key only).

    External Telemedicine Connector

  • Webhooks

    HMAC-signed outbound events for orders, stock, and prescriptions.

    Webhooks

How it works

sequenceDiagram
    participant Partner
    participant API as PharmaOne API
    participant Backend as PharmaOne Backend

    Partner->>API: POST /v2/.../auth/token + apikey
    API->>Backend: Validate key
    Backend-->>Partner: JWT (1h, scoped)

    Partner->>API: GET /v2/.../orders + Bearer JWT
    API->>Backend: Validate token + scopes
    Backend-->>Partner: JSON response

Environments

Environment API base URL
Production https://manager.prod.pharmaone.shop
Sandbox Provided by your pharmacy contact

Replace {orgId} in all paths with your organization id (e.g. org1).

Quick start

export BASE="https://manager.prod.pharmaone.shop"
export ORG="org1"
export APIKEY="your-integration-api-key"

TOKEN=$(curl -s -X POST "$BASE/api/v2/public/orgs/$ORG/auth/token" \
  -H "apikey: $APIKEY" | jq -r .access_token)

curl -s "$BASE/api/v2/public/orgs/$ORG/shops" \
  -H "Authorization: Bearer $TOKEN" | jq .

Configure API keys in Manager → Org Settings → Integrations.