API Authentication Guide

Access TransparentMedz data programmatically through our REST API. This guide covers authentication setup.

Getting API Keys

Navigate to your account settings and select the "API" tab. Click "Generate API Key" to create a new key. Store it securely -- you will not be able to view it again.

Authentication Method

All API requests must include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Rate Limits

• Free tier: 100 requests/day

• Pro tier: 10,000 requests/day

• Enterprise: Custom limits

Endpoints

Base URL: `https://api.transparentmedz.ca/v1`

• `GET /medications/search` -- Search medications

• `GET /medications/:id/prices` -- Get prices for a medication

• `GET /pharmacies` -- List pharmacies

Error Handling

The API returns standard HTTP status codes. Rate limit errors return 429 with a `Retry-After` header.