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

# Search providers by zipcode

`GET /v1/providers/search`

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
- `name` 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
- `403` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/bluehive-health/apis/bluehive-api.md) · [All operations](https://skmtc.net/bluehive-health/apis/bluehive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluehive-health/bluehive-api/revisions/ae97a9add0ba/schema)