---
title: "Search providers by zipcode"
method: GET
path: "/v1/providers/search"
tags: ["Provider Directory"]
---

# Search providers by zipcode

`GET /v1/providers/search`

## Request

- Base URL: `https://api.bluehive.com`
- URL: `https://api.bluehive.com/v1/providers/search`
- Auth: none required
- TypeScript: <https://skmtc.dev/bluehive-health/apis/bluehive-api/docs/v1/providers/search/get.ts> (a function with typed inputs; its response is checked against the schema)

Search for healthcare providers near a given zipcode. Optionally filter by services and customize the search radius. When services are provided, only providers offering those services are returned with pricing info.

## Query parameters

- `zipcode` string, required
- `radius` string
- `services` string
- `providerId` string
- `employerId` string
- `brandId` string
- `limit` string

## Response `200`

Default Response

- object
  - `status` string, required
  - `count` number, required
  - `zipcode` string, required
  - `radius` number, required
  - `providers` object[], required
    - `_id` string
    - `name` string
    - `slug` string
    - `address` object
      - `street1` string
      - `street2` string
      - `city` string
      - `state` string
      - `postalCode` string
      - `county` string
      - `country` string
    - `email` string
    - `logoURL` string
    - `phone_numbers` object[]
      - `type` string
      - `number` string
    - `loc` object
      - `type` string
      - `coordinates` number[]
    - `distance` number: Distance from zipcode in miles
    - `url` string
    - `services` object[]
      - `serviceId` string
      - `name` string
      - `slug` string
      - `price` number

## Other responses

- `400`: Default Response
- `500`: Default Response

## Changes

- **2026-10-16** `a8bcbdf02e33`: 1 warning, 1 info
  - deleted the `query` request parameter `name`
  - removed the non-success response with the status `403`
- **2026-03-17** `4abf46539e83`: 2 info
  - added the new optional `query` request parameter `name`
  - added the non-success response with the status `403`
- **2026-02-06** `1874b7b2f69f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bluehive-health/apis/bluehive-api/changes/v1/providers/search/get.md)

---

[API](https://skmtc.dev/bluehive-health/apis/bluehive-api.md) - [All operations](https://skmtc.dev/bluehive-health/apis/bluehive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluehive-health/apis/bluehive-api/revisions/a8bcbdf02e33?raw)