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

# Provider Search

`GET /v1/providers/lookup`

## Request

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

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.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)