> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /npi/providers/search

> Search the US NPI registry (NPPES) for healthcare providers by name, organization, specialty (taxonomy) and location. Filter by provider type (individual / organization), first and last name, organization name, taxonomy description, city, state, postal code and country, with control over which address and name the filters apply to. Returns each matching provider's full record: type, dates, basic block, taxonomies, addresses, identifiers, other names, practice locations and endpoints.

**Price:** 10 credits per 200 results



## OpenAPI

````yaml /openapi/gov-public-sector.json post /api/npi/providers/search
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/npi/providers/search:
    post:
      tags:
        - /npi
      summary: /npi/providers/search
      description: >-
        Search the US NPI registry (NPPES) for healthcare providers by name,
        organization, specialty (taxonomy) and location. Filter by provider type
        (individual / organization), first and last name, organization name,
        taxonomy description, city, state, postal code and country, with control
        over which address and name the filters apply to. Returns each matching
        provider's full record: type, dates, basic block, taxonomies, addresses,
        identifiers, other names, practice locations and endpoints.


        **Price:** 10 credits per 200 results
      operationId: __api_npi_providers_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NpiProvidersSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NpiProvider'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    NpiProvidersSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        enumeration_type:
          anyOf:
            - $ref: '#/components/schemas/NpiEnumerationType'
            - type: 'null'
        first_name:
          anyOf:
            - type: string
            - type: 'null'
        last_name:
          anyOf:
            - type: string
            - type: 'null'
        organization_name:
          anyOf:
            - type: string
            - type: 'null'
        taxonomy_description:
          anyOf:
            - type: string
            - type: 'null'
        city:
          anyOf:
            - type: string
            - type: 'null'
        state:
          anyOf:
            - $ref: '#/components/schemas/NpiUsState'
            - type: 'null'
        postal_code:
          anyOf:
            - type: string
            - type: 'null'
        country_code:
          anyOf:
            - type: string
            - type: 'null'
        address_purpose:
          anyOf:
            - $ref: '#/components/schemas/NpiAddressPurpose'
            - type: 'null'
        name_purpose:
          anyOf:
            - $ref: '#/components/schemas/NpiNamePurpose'
            - type: 'null'
        use_first_name_alias:
          anyOf:
            - type: boolean
            - type: 'null'
        count:
          type: integer
          maximum: 1200
          minimum: 1
      type: object
      required:
        - count
    NpiProvider:
      properties:
        '@type':
          type: string
          default: NpiProvider
        number:
          type: string
        enumeration_type:
          anyOf:
            - type: string
            - type: 'null'
        created_at:
          anyOf:
            - type: integer
            - type: 'null'
        updated_at:
          anyOf:
            - type: integer
            - type: 'null'
        basic:
          anyOf:
            - $ref: '#/components/schemas/NpiBasic'
            - type: 'null'
        addresses:
          items:
            $ref: '#/components/schemas/NpiAddress'
          type: array
          default: []
        practice_locations:
          items:
            $ref: '#/components/schemas/NpiAddress'
          type: array
          default: []
        taxonomies:
          items:
            $ref: '#/components/schemas/NpiTaxonomy'
          type: array
          default: []
        identifiers:
          items:
            $ref: '#/components/schemas/NpiIdentifier'
          type: array
          default: []
        other_names:
          items:
            $ref: '#/components/schemas/NpiOtherName'
          type: array
          default: []
        endpoints:
          items:
            $ref: '#/components/schemas/NpiEndpoint'
          type: array
          default: []
      type: object
      required:
        - number
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    NpiEnumerationType:
      type: string
      enum:
        - NPI-1
        - NPI-2
    NpiUsState:
      type: string
      enum:
        - AL
        - AK
        - AZ
        - AR
        - CA
        - CO
        - CT
        - DE
        - DC
        - FL
        - GA
        - HI
        - ID
        - IL
        - IN
        - IA
        - KS
        - KY
        - LA
        - ME
        - MD
        - MA
        - MI
        - MN
        - MS
        - MO
        - MT
        - NE
        - NV
        - NH
        - NJ
        - NM
        - NY
        - NC
        - ND
        - OH
        - OK
        - OR
        - PA
        - RI
        - SC
        - SD
        - TN
        - TX
        - UT
        - VT
        - VA
        - WA
        - WV
        - WI
        - WY
        - AS
        - GU
        - MP
        - PR
        - VI
        - AA
        - AE
        - AP
    NpiAddressPurpose:
      type: string
      enum:
        - LOCATION
        - MAILING
        - PRIMARY
        - SECONDARY
    NpiNamePurpose:
      type: string
      enum:
        - AO
        - PROVIDER
    NpiBasic:
      properties:
        '@type':
          type: string
          default: NpiBasic
        first_name:
          anyOf:
            - type: string
            - type: 'null'
        last_name:
          anyOf:
            - type: string
            - type: 'null'
        middle_name:
          anyOf:
            - type: string
            - type: 'null'
        name_prefix:
          anyOf:
            - type: string
            - type: 'null'
        name_suffix:
          anyOf:
            - type: string
            - type: 'null'
        credential:
          anyOf:
            - type: string
            - type: 'null'
        gender:
          anyOf:
            - type: string
            - type: 'null'
        sole_proprietor:
          anyOf:
            - type: string
            - type: 'null'
        organization_name:
          anyOf:
            - type: string
            - type: 'null'
        organizational_subpart:
          anyOf:
            - type: string
            - type: 'null'
        parent_organization_name:
          anyOf:
            - type: string
            - type: 'null'
        status:
          anyOf:
            - type: string
            - type: 'null'
        enumeration_date:
          anyOf:
            - type: string
            - type: 'null'
        certification_date:
          anyOf:
            - type: string
            - type: 'null'
        authorized_official:
          anyOf:
            - $ref: '#/components/schemas/NpiAuthorizedOfficial'
            - type: 'null'
      type: object
    NpiAddress:
      properties:
        '@type':
          type: string
          default: NpiAddress
        address_purpose:
          anyOf:
            - type: string
            - type: 'null'
        address_type:
          anyOf:
            - type: string
            - type: 'null'
        address_1:
          anyOf:
            - type: string
            - type: 'null'
        address_2:
          anyOf:
            - type: string
            - type: 'null'
        city:
          anyOf:
            - type: string
            - type: 'null'
        state:
          anyOf:
            - type: string
            - type: 'null'
        postal_code:
          anyOf:
            - type: string
            - type: 'null'
        country_code:
          anyOf:
            - type: string
            - type: 'null'
        country_name:
          anyOf:
            - type: string
            - type: 'null'
        phone:
          anyOf:
            - type: string
            - type: 'null'
        fax:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    NpiTaxonomy:
      properties:
        '@type':
          type: string
          default: NpiTaxonomy
        code:
          anyOf:
            - type: string
            - type: 'null'
        license:
          anyOf:
            - type: string
            - type: 'null'
        is_primary:
          anyOf:
            - type: boolean
            - type: 'null'
        state:
          anyOf:
            - type: string
            - type: 'null'
        taxonomy_group:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    NpiIdentifier:
      properties:
        '@type':
          type: string
          default: NpiIdentifier
        code:
          anyOf:
            - type: string
            - type: 'null'
        issuer:
          anyOf:
            - type: string
            - type: 'null'
        identifier:
          anyOf:
            - type: string
            - type: 'null'
        state:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    NpiOtherName:
      properties:
        '@type':
          type: string
          default: NpiOtherName
        name_type:
          anyOf:
            - type: string
            - type: 'null'
        code:
          anyOf:
            - type: string
            - type: 'null'
        organization_name:
          anyOf:
            - type: string
            - type: 'null'
        first_name:
          anyOf:
            - type: string
            - type: 'null'
        last_name:
          anyOf:
            - type: string
            - type: 'null'
        middle_name:
          anyOf:
            - type: string
            - type: 'null'
        name_prefix:
          anyOf:
            - type: string
            - type: 'null'
        name_suffix:
          anyOf:
            - type: string
            - type: 'null'
        credential:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    NpiEndpoint:
      properties:
        '@type':
          type: string
          default: NpiEndpoint
        endpoint_type:
          anyOf:
            - type: string
            - type: 'null'
        endpoint_type_description:
          anyOf:
            - type: string
            - type: 'null'
        endpoint:
          anyOf:
            - type: string
            - type: 'null'
        endpoint_description:
          anyOf:
            - type: string
            - type: 'null'
        affiliation:
          anyOf:
            - type: string
            - type: 'null'
        affiliation_name:
          anyOf:
            - type: string
            - type: 'null'
        use:
          anyOf:
            - type: string
            - type: 'null'
        use_description:
          anyOf:
            - type: string
            - type: 'null'
        content_type:
          anyOf:
            - type: string
            - type: 'null'
        content_type_description:
          anyOf:
            - type: string
            - type: 'null'
        content_other_description:
          anyOf:
            - type: string
            - type: 'null'
        address_type:
          anyOf:
            - type: string
            - type: 'null'
        address_1:
          anyOf:
            - type: string
            - type: 'null'
        address_2:
          anyOf:
            - type: string
            - type: 'null'
        city:
          anyOf:
            - type: string
            - type: 'null'
        state:
          anyOf:
            - type: string
            - type: 'null'
        postal_code:
          anyOf:
            - type: string
            - type: 'null'
        country_code:
          anyOf:
            - type: string
            - type: 'null'
        country_name:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
    NpiAuthorizedOfficial:
      properties:
        '@type':
          type: string
          default: NpiAuthorizedOfficial
        first_name:
          anyOf:
            - type: string
            - type: 'null'
        last_name:
          anyOf:
            - type: string
            - type: 'null'
        middle_name:
          anyOf:
            - type: string
            - type: 'null'
        name_prefix:
          anyOf:
            - type: string
            - type: 'null'
        name_suffix:
          anyOf:
            - type: string
            - type: 'null'
        credential:
          anyOf:
            - type: string
            - type: 'null'
        official_title:
          anyOf:
            - type: string
            - type: 'null'
        phone:
          anyOf:
            - type: string
            - type: 'null'
      type: object
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````