# Search providers

Search for providers using flexible location options and query string. Supports searching by provider name, hospital group, or other text combined with various location formats.


Endpoint: POST /providers/search
Version: 1.6.1
Security: bearerAuth

## Request fields (application/json):

  - `query` (string)
    Search query for provider names, hospital groups, specialties, etc.
    Example: "Dr. Johnson Mount Sinai"

  - `location` (any, required)

  - `radius` (number, required)
    Search radius in miles
    Example: 10

  - `pageSize` (integer)
    Number of results to return per page

  - `offset` (integer)
    Number of results to skip for pagination

## Response 200 fields (application/json):

  - `results` (array)

  - `results.provider` (object)

  - `results.provider.id` (string)
    Example: "070851a5-9501-4801-9074-d84b88b8a804"

  - `results.provider.npis` (array)
    Example: ["1234567890"]

  - `results.provider.doingBusinessAs` (string,null)

  - `results.provider.firstName` (string,null)
    Example: "Jane"

  - `results.provider.lastName` (string,null)
    Example: "Smith"

  - `results.provider.middleName` (string,null)
    Example: "Marie"

  - `results.provider.prefix` (string,null)
    Example: "Dr."

  - `results.provider.suffix` (string,null)
    Example: "Jr"

  - `results.provider.gender` (string)
    Enum: "F", "M", "X"

  - `results.provider.credentials` (array)
    Example: ["MD"]

  - `results.provider.languages` (array)
    Example: ["English"]

  - `results.provider.groupAffiliations` (array)
    Example: ["Vision Medical Group"]

  - `results.provider.hospitalAffiliations` (array)
    Example: ["Rogue County Medical"]

  - `results.locations` (array)

  - `results.locations.id` (string)
    Provider location identifier
    Example: "loc_001"

  - `results.locations.address` (object)

  - `results.locations.address.streetLine1` (string)
    Primary street address line
    Example: "123 Main St"

  - `results.locations.address.streetLine2` (string,null)
    Secondary street address line (apartment, suite, etc.)
    Example: "Suite 200"

  - `results.locations.address.streetLine3` (string,null)
    Tertiary street address line
    Example: "Rm 22"

  - `results.locations.address.city` (string)
    City name
    Example: "New York"

  - `results.locations.address.state` (string)
    State abbreviation
    Example: "NY"

  - `results.locations.address.zip` (string)
    ZIP code
    Example: "10001"

  - `results.locations.address.fullAddress` (string)
    Complete formatted address string
    Example: "123 Main St Suite 200, New York, NY 10001"

  - `results.locations.address.latitude` (number,null)
    Latitude coordinate (optional)
    Example: 40.7128

  - `results.locations.address.longitude` (number,null)
    Longitude coordinate (optional)
    Example: -74.006

  - `results.locations.phoneNumbers` (array)
    Example: ["+14155552671"]

  - `results.locations.faxNumbers` (array)
    Example: ["+14155552671"]

  - `results.locations.website` (string,null)
    Example: "https://www.example.com"

  - `results.locations.email` (string,null)
    Example: "contact@example.com"

  - `results.locations.groupAffiliations` (array)
    Groups affiliated with this location
    Example: ["Community Health Center"]

  - `results.locations.hospitalAffiliations` (array)
    Hospitals affiliated with this location
    Example: ["Rogue County Medical"]

  - `results.locations.pcpEligible` (boolean)
    Whether the provider may be eligible for PCP designation at this location

  - `pageSize` (integer)
    Page size of current page
    Example: 50

  - `offset` (integer)
    Current offset

  - `totalCount` (integer)
    Total number of results available
    Example: 150