---
title: "Provider Search"
method: GET
path: "/v1/providers/lookup"
tags: ["Healthcare Providers"]
---

# Provider Search

`GET /v1/providers/lookup`

Search for healthcare providers by NPI number, name, or location proximity.

## Query parameters

- `firstname` string
- `lastname` string
- `npi` string
- `zipcode` string

## Response `200`

Default Response

- object
  - `providers` object[], required — List of matching providers
    - `lastname` string, required — Provider last name or organization name
    - `firstname` string, required — Provider first name
    - `address_1` string, required — Primary address line
    - `address_2` string, required — Secondary address line (suite, unit, etc.)
    - `city` string, required — City
    - `state_province` string, required — State or province code
    - `country` string, required — Country code
    - `postal_code` string, required — Postal/ZIP code
    - `work_phone` string, required — Work phone number
    - `fax_number` string, required — Fax number
    - `npi` string, required — National Provider Identifier (NPI) number
    - `distance` number, required — Distance in miles from the provided ZIP code
  - `count` number, required — Number of providers found

## Other responses

- `400` — Default Response
- `401` — 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)