Facilities
Check a licence number against the PPB facility register.
Verify a facility licence
https://api.dawatrack.com/partner-api/v1/facilities/verify/
Check a licence number against the PPB register of Kenyan pharmacies, hospitals, wholesalers and manufacturers, synced nightly.
facilities:read
Limit 5,000 per day
Pass the licence number as ?license_number=. The facility doesn't have to be on DawaTrack.
Always returns 200. found_in_ppb_register: false is a valid answer, not an error. 400 if license_number is missing.
is_dawatrack_supplier and is_dawatrack_pharmacy are a separate check against DawaTrack's own accounts. Read them on their own terms.
Query parameters
-
license_numberstring RequiredThe PPB licence number to check.
Example request
curl -X GET https://api.dawatrack.com/partner-api/v1/facilities/verify/ \
-H "Authorization: Bearer $DAWATRACK_TOKEN"
import requests
token = "..." # from POST /oauth/token/
response = requests.get(
"https://api.dawatrack.com/partner-api/v1/facilities/verify/",
headers={"Authorization": f"Bearer {token}"},
)
response.raise_for_status()
print(response.json())
const token = "..."; // from POST /oauth/token/
const response = await fetch("https://api.dawatrack.com/partner-api/v1/facilities/verify/", {
method: "GET",
headers: {
Authorization: `Bearer ${token}`,
},
});
console.log(await response.json());
Response fields
-
license_numberstring -
found_in_ppb_registerboolean -
facility_namestring or nullThe facility's name.
-
business_typestring or null -
countystring or null -
license_statusstring or null -
valid_tilldate or null -
ppb_last_synced_atdatetime or null -
is_dawatrack_supplierbooleanWhether this licence number also belongs to a supplier account on DawaTrack. Independent of found_in_ppb_register.
-
is_dawatrack_pharmacybooleanWhether this licence number also belongs to a facility account on DawaTrack. Independent of found_in_ppb_register.
Example response
{
"license_number": "PPB/R/2026/0001",
"found_in_ppb_register": true,
"facility_name": "PHARMACY A",
"business_type": "RETAIL",
"county": "Nairobi",
"license_status": "VALID",
"valid_till": "2026-12-31",
"ppb_last_synced_at": "2026-10-10T04:30:12Z",
"is_dawatrack_supplier": false,
"is_dawatrack_pharmacy": true
}
Status codes
200 | OK |
400 | The request is invalid, for example a malformed GTIN or a missing field |
401 | No valid access token |
403 | Your credential lacks the scope, partner type or environment this needs |
429 | Rate limit exceeded |
Partner API v1. The API reference is generated from the API's own code.