API Changelog
Track every change to the TransparentMedz API.
Batch price comparison endpoint
New POST /v1/prices/compare/batch endpoint allows comparing prices for up to 50 drugs in a single request. Returns aggregated pharmacy pricing data.
Webhook retry configuration
Webhook subscriptions now support custom retry policies. Configure max retries (1-10) and backoff strategy (linear or exponential).
Faster drug search with fuzzy matching
Drug search now uses an improved fuzzy matching algorithm, reducing average response time from 120ms to 45ms while improving result relevance.
Price response format updated
The price field in /v1/prices/* endpoints is now returned as a string instead of a float to prevent floating point precision issues. E.g., "12.99" instead of 12.99.
Migration Guide
// Before (v1.3.x)
const price = response.data.price; // 12.99 (number)
// After (v1.4.0)
const price = parseFloat(response.data.price); // "12.99" -> 12.99
// Or use the new price_cents field
const priceCents = response.data.price_cents; // 1299 (integer)Price history endpoint
New GET /v1/prices/{drugId}/history endpoint returns historical pricing data with configurable date ranges. Supports daily, weekly, and monthly aggregation.
Legacy search parameter 'q' deprecated
The 'q' query parameter on /v1/drugs/search is deprecated in favor of 'query'. The 'q' parameter will be removed in v2.0.0.
Pharmacy availability data
Drug price responses now include real-time stock availability status for each pharmacy: in_stock, low_stock, out_of_stock, or unknown.
Geographic filtering
All pharmacy-related endpoints now support latitude/longitude and radius parameters to filter results by location. Defaults to 50km radius.
Rate limit header consistency
Fixed an issue where X-RateLimit-Remaining header was sometimes off by one. Headers now accurately reflect the current state.
Authentication header format change
API keys must now be passed in the Authorization header with a Bearer prefix instead of the custom X-API-Key header.
Migration Guide
// Before (v1.1.x)
headers: { "X-API-Key": "tm_live_abc123" }
// After (v1.2.0)
headers: { "Authorization": "Bearer tm_live_abc123" }Webhook support
Subscribe to real-time events including price.changed, drug.recalled, and generic.available via the new /v1/webhooks endpoint.
Pagination standardization
All list endpoints now use cursor-based pagination with consistent next_cursor and has_more fields in the response.
Drug interaction checker
New GET /v1/drugs/interactions endpoint checks for known interactions between multiple drugs. Supports up to 10 DINs per request.
Fixed incorrect DIN validation
DIN validation now correctly accepts 8-digit numbers with leading zeros. Previously, DINs starting with 0 were incorrectly rejected.
Pharmacy hours timezone handling
Pharmacy operating hours now correctly account for the pharmacy's local timezone instead of always returning UTC.
Initial API release
Launch of the TransparentMedz API with endpoints for drug search, price comparison, pharmacy lookup, and price alerts. Includes SDKs for JavaScript, Python, Ruby, and Go.