DawaTrack Partner API

Connect your ERP, warehouse system or pharmacy system to DawaTrack. Report batches and events, read where a batch went, run recalls and receive orders and recall events by webhook.

Quickstart

Get sandbox credentials, get a token and make your first call.

Authentication

OAuth2 client credentials and bearer tokens.

Webhooks

Receive orders, shipment confirmations, returns and recall events as they happen.

API reference

Every endpoint, parameter and field, generated from the API's code.

Base URL

Every endpoint is relative to this address. All requests and responses are JSON over HTTPS.

Base URL

https://api.dawatrack.com/partner-api/v1

The same API is also served at https://dawatrack.com/partner-api/v1.

Who uses it

Every credential belongs to a partner of one type. The type decides what the credential can do.

Partner type	What it can do
Manufacturer	Register its products, confirm shipments, record events, pack units into SSCCs, authorize contract packers, open recalls and drills, read recall reports, and manage webhooks.
Distributor or wholesaler	Read products and batches, record events, read and acknowledge recalls for the facilities it's linked to, and manage webhooks.
Pharmacy or hospital	The same as a distributor: read products and batches, record events, read and acknowledge recalls for its linked facilities, and manage webhooks.

The exact scopes each type receives are listed under Scopes and partner types.

API reference

Access tokens Exchange your client credentials for a bearer token. 1 endpoint Products The shared medicine catalogue, looked up by GS1 GTIN. 3 endpoints Facilities Check a licence number against the PPB facility register. 1 endpoint Parties outside DawaTrack The suppliers and buyers outside DawaTrack your events named, and the contact a recall reaches them by. 2 endpoints Batches Where a batch went: deliveries, the distribution tree and EPCIS export. 8 endpoints Events The append-only supply chain event log, one event or up to 1,000 at a time. 4 endpoints Receipts Shipments other suppliers sent you, and confirming what arrived. 2 endpoints Consignments Your consignments (despatch advice) and, line by line, what the receiver recorded of them (receiving advice): whether each arrived, short, damaged or refused. 2 endpoints Purchase orders Orders pharmacies placed with you: confirm, reject, and declare what you're delivering. 5 endpoints Units Serialized units and their custody trail. 2 endpoints Aggregations What is packed in a case or pallet, identified by its SSCC. 3 endpoints Packing authorizations Let a contract packer pack your products. 3 endpoints Recalls Open, follow, acknowledge and report on recalls. 9 endpoints Public recall lookup Has this batch been recalled? No credentials needed. 1 endpoint Capture links A buyer outside DawaTrack records receiving a consignment, with the one-time token the pharmacy sent it. 2 endpoints Webhook subscriptions Register URLs to receive events, test them and read the delivery log. 5 endpoints Service status The API version and the health of its services. 2 endpoints

What the API doesn't do

There is no PPB partner type. PPB has no live API, so a statutory recall is entered by DawaTrack staff, not through this API. Recalls opened here are always voluntary.
DawaTrack doesn't submit data to a live PPB system yet. Batch history can be exported as GS1 EPCIS 2.0.
A party outside DawaTrack has no credential, so its onward deliveries and units used are recorded on its own page, not through the API. They reach you on the batch tree and in recalls. See Shipments and confirmation.
Links and recall notices to parties outside DawaTrack go by email only. SMS isn't used yet.

Partner API v1. The API reference is generated from the API's own code.