Provider Directory

Finding Nearby Clinics with Services

The provider directory search is the primary way to find clinics that can perform specific services. Provide a zip code and optional service IDs to get pricing-aware results.

const response = await fetch(
  'https://api.bluehive.com/v1/providers/search?' + new URLSearchParams({
    zipcode: '48201',
    radius: '25',
    services: 'svc_drug_test,svc_physical_dot',
    limit: '10'
  }),
);

const data = await response.json();
// Each provider includes services with per-provider pricing:
// {
//   "providers": [{
//     "name": "QuickCare Occupational Health",
//     "distance": 3.2,
//     "services": [
//       { "serviceId": "svc_drug_test", "name": "10-Panel Drug Test", "price": 45 },
//       { "serviceId": "svc_physical_dot", "name": "DOT Physical", "price": 95 }
//     ]
//   }]
// }

Filtering Options

The directory search supports several filter parameters:

• zipcode (required) — US postal code to search near (5-digit or ZIP+4)
• radius — Search radius in miles (default: 25, max: 100)
• services — Comma-separated service IDs to filter by
• providerId — Restrict to specific provider(s)
• employerId — Get employer-specific pricing
• brandId — Filter services by brand
• limit — Max providers to return (default: 50, max: 200)