Skip to main content

Facilities

Check a licence number against the PPB facility register.

Verify a facility licence

GET 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.

Scope 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_number string Required

    The 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_number string
  • found_in_ppb_register boolean
  • facility_name string or null

    The facility's name.

  • business_type string or null
  • county string or null
  • license_status string or null
  • valid_till date or null
  • ppb_last_synced_at datetime or null
  • is_dawatrack_supplier boolean

    Whether this licence number also belongs to a supplier account on DawaTrack. Independent of found_in_ppb_register.

  • is_dawatrack_pharmacy boolean

    Whether this licence number also belongs to a facility account on DawaTrack. Independent of found_in_ppb_register.

Example response

JSON
{
  "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

200OK
400The request is invalid, for example a malformed GTIN or a missing field
401No valid access token
403Your credential lacks the scope, partner type or environment this needs
429Rate limit exceeded

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