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/suppliersVerified manufacturers and distributors that list public products in the requested division.
| division | required | human | animal |
| country | optional | Exact country name, e.g. Australia |
| region | optional | Exact region name |
| type | optional | manufacturer | distributor |
| limit / offset | optional | Paging; 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/productsPublic catalogue products from verified suppliers, strictly limited to one division.
| division | required | human | animal |
| q | optional | Product name contains |
| inn | optional | INN / active substance (case-insensitive exact) |
| category | optional | Exact category |
| supplier_id | optional | Supplier UUID |
| limit / offset | optional | Paging |
{"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/inventoryRegional stock positions for public products from verified suppliers in one division.
| division | required | human | animal |
| region | optional | Exact region |
| country | optional | Exact country |
| product_id | optional | Product UUID |
| limit / offset | optional | Paging |
{"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":"…"}}
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_division / invalid_parameter | Missing or invalid query parameter. |
| 401 | missing_api_key / invalid_api_key | No key, malformed key, or key revoked. |
| 403 | organization_not_verified | The key's organization is not verified. |
| 500 | server_error | Unexpected error; retry later. |
