Medicare DB API Documentation
Authentication: All endpoints except /health and /api/docs require an API key via the X-API-Key header.
Endpoints
GET
/api/v1/plans/{zip_code}
Requires API Key
Get all Medicare plans available for a specific ZIP code.
Response includes plan details, benefits, and coverage information.
GET
/api/v1/plan/{h_number}/{plan_id}
Requires API Key
Get detailed information for a specific Medicare plan.
GET
/api/v1/top_plans/{zip_code}
Requires API Key
Get top 3 Medicare plans for a ZIP code based on benefits criteria.
GET
/api/v1/lowest_out_of_pocket/{zip_code}
Requires API Key
Get plans with lowest out-of-pocket costs for a ZIP code.
GET
/api/v1/part_b_giveback/{zip_code}
Requires API Key
Get Medicare plans with Part B Giveback Benefits for a ZIP code.
Returns plans that offer Part B premium rebates/reductions.
GET
/health
Health check endpoint. No authentication required.
GET
/api/docs
JSON format API documentation. No authentication required.
Authentication
To obtain an API key, contact the API administrator. Include the key in all requests using the
X-API-Key header.
Rate Limiting
API calls are rate-limited based on your API key's configuration. Contact the administrator
for your specific limits.