Developer API

MEDZA 360 REST API v1

Read-only access for verified organizations to verified suppliers, public products and regional inventory. Every request is scoped to exactly one health division — Human Health and Animal Health data are never mixed.

Authentication

Send your key in the Authorization header (or X-API-Key). Keys are shown once and stored only as SHA-256 hashes.

curl "https://medza360.com.au/api/v1/products?division=human&inn=amoxicillin" \
  -H "Authorization: Bearer mdz_live_your_key"

Endpoints

GET/api/v1/suppliers

Verified manufacturers and distributors that list public products in the requested division.

divisionrequiredhuman | animal
countryoptionalExact country name, e.g. Australia
regionoptionalExact region name
typeoptionalmanufacturer | distributor
limit / offsetoptionalPaging; limit 1–100 (default 50)
{"data":[{"id":"…","name":"Acme Pharma","slug":"acme-pharma","type":"manufacturer","country":"India","region":"Asia","website":"…","verified":true}],"meta":{"division":"Human Health","total":1,"limit":50,"offset":0}}
Try it
GET/api/v1/products

Public catalogue products from verified suppliers, strictly limited to one division.

divisionrequiredhuman | animal
qoptionalProduct name contains
innoptionalINN / active substance (case-insensitive exact)
categoryoptionalExact category
supplier_idoptionalSupplier UUID
limit / offsetoptionalPaging
{"data":[{"id":"…","name":"Amoxicillin 500mg","inn":"amoxicillin","health_segment":"Human Health","unit":"capsules","moq":1000,"list_price":0.04,"currency":"USD","supplier":{"id":"…","name":"Acme Pharma"}}],"meta":{…}}
Try it
GET/api/v1/inventory

Regional stock positions for public products from verified suppliers in one division.

divisionrequiredhuman | animal
regionoptionalExact region
countryoptionalExact country
product_idoptionalProduct UUID
limit / offsetoptionalPaging
{"data":[{"id":"…","warehouse":"Mumbai DC","country":"India","region":"Asia","quantity":50000,"allocated":5000,"available":45000,"product":{…},"supplier":{…}}],"meta":{…}}
Try it

Errors

Errors return JSON: {"error":{"code":"…","message":"…"}}

StatusCodeMeaning
400invalid_division / invalid_parameterMissing or invalid query parameter.
401missing_api_key / invalid_api_keyNo key, malformed key, or key revoked.
403organization_not_verifiedThe key's organization is not verified.
500server_errorUnexpected error; retry later.