Reference Data API

Multi-domain reference catalogs. JSON only, token-authenticated, fast.

Authorization header: Bearer <token>

Locations — postal codes (SEPOMEX)

GET /v1/locations/{country}
GET /v1/locations/{country}/{postal_code}

Example response

{
  "data": {
    "country": { "alpha_2": "MX", "name": "Mexico" },
    "postal_code": "42186",
    "state": { "name": "Hidalgo", "lat": 20.0911, "lon": -98.7624 },
    "city": { "name": "Pachuca", "lat": null, "lon": null },
    "neighborhoods": [
      { "name": "Tellez", "type": "Pueblo", "lat": null, "lon": null }
    ]
  }
}

COFEPRIS — authorized drug registry (MX)

GET /v1/cofepris/drugs/search?q={query}&status={active|cancelled|revoked|any}
GET /v1/cofepris/drugs/{registro_sanitario}
GET /v1/cofepris/categories
GET /v1/cofepris/classifications
GET /v1/cofepris/forms
GET /v1/cofepris/providers?q={query}

Example response

{
  "data": {
    "registro_sanitario": "123M2020 SSA",
    "denominacion_distintiva": "EJEMPLEX",
    "denominacion_generica": "Paracetamol",
    "category": { "slug": "alopatico", "name": "Alopático" },
    "classification": { "code": "IV", "name": "Prescripción médica" },
    "form": "Tableta",
    "provider": "Laboratorios Demo, S.A. de C.V.",
    "status": "active",
    "source": "cofepris"
  }
}

Each token has a set of scopes (locations:read, cofepris:read). Requests to an endpoint without the matching scope return 403 insufficient_scope.