> ## 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

> Get a US healthcare provider's full NPI registry (NPPES) record by its 10-digit National Provider Identifier. Returns the provider type (individual or organization), enumeration and last-update dates, the basic block (name, credentials, gender, sole-proprietor flag or organization name and authorized official), taxonomies (specialties with NUCC code, license number and primary flag), practice and mailing addresses with phone and fax, additional identifiers, other names, practice locations and HIE endpoints.

**Price:** 1 credit

**⚠️ Common errors:** 412: No provider found for the given NPI number



## OpenAPI

````yaml /openapi/gov-public-sector.json post /api/npi/providers
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:
    post:
      tags:
        - /npi
      summary: /npi/providers
      description: >-
        Get a US healthcare provider's full NPI registry (NPPES) record by its
        10-digit National Provider Identifier. Returns the provider type
        (individual or organization), enumeration and last-update dates, the
        basic block (name, credentials, gender, sole-proprietor flag or
        organization name and authorized official), taxonomies (specialties with
        NUCC code, license number and primary flag), practice and mailing
        addresses with phone and fax, additional identifiers, other names,
        practice locations and HIE endpoints.


        **Price:** 1 credit


        **⚠️ Common errors:** 412: No provider found for the given NPI number
      operationId: __api_npi_providers_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NpiProvidersPayload'
      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:
    NpiProvidersPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        number:
          type: string
      type: object
      required:
        - number
    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
    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

````