Services

Manage occupational health services. Create, update, search, and configure service offerings with pricing.

6 endpoints

Guide

Services represent individual occupational health tests and procedures — drug tests, physicals, lab panels, and more. Manage your service catalog, configure pricing, and search for services with geographic pricing data.

Service Structure

Each service has a name, optional brand association, and can be organized using family/sub-family/group hierarchies. Services also support aliases (alternative names) and codes (CPT, LOINC, etc.) for interoperability.

Create a service

{
  "name": "10-Panel Drug Screen",
  "description": "Standard 10-panel urine drug test",
  "brandId": "brand_bluehive",
  "family": "Drug Testing",
  "subFamily": "Urine",
  "groupName": "Standard Panels",
  "aliases": [
    { "name": "10-Panel Urine Drug Test" },
    { "name": "10 Panel Drug Screen" }
  ],
  "codes": [
    { "type": "CPT", "code": "80305" },
    { "type": "LOINC", "code": "88686-5" }
  ]
}

Service Search with Pricing

Search for services by geographic area to get aggregated pricing data (min, avg, max) across providers in the search radius. This is useful for building cost estimators and comparing provider pricing.

Search services with pricing

Get pricing stats for services near a zip code

curl "https://api.bluehive.com/v1/services/search/48201/25?brandId=brand_bluehive" \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "login-token: YOUR_LOGIN_TOKEN" \
  -H "user-id: YOUR_USER_ID"

# Response:
# {
#   "status": "ok",
#   "services": [
#     {
#       "_id": "svc_drug_test",
#       "name": "10-Panel Drug Screen",
#       "family": "Drug Testing",
#       "minPrice": 35,
#       "avgPrice": 48.50,
#       "maxPrice": 65
#     }
#   ]
# }