Skip to main content
POST
/
api
/
npi
/
providers
/
search
/npi/providers/search
curl --request POST \
  --url https://api.anysite.io/api/npi/providers/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 600,
  "timeout": 300,
  "first_name": "<string>",
  "last_name": "<string>",
  "organization_name": "<string>",
  "taxonomy_description": "dentist",
  "city": "<string>",
  "postal_code": "<string>",
  "country_code": "US",
  "use_first_name_alias": true
}
'
[
  {
    "number": "<string>",
    "@type": "NpiProvider",
    "enumeration_type": "<string>",
    "created_at": 123,
    "updated_at": 123,
    "basic": {
      "@type": "NpiBasic",
      "first_name": "<string>",
      "last_name": "<string>",
      "middle_name": "<string>",
      "name_prefix": "<string>",
      "name_suffix": "<string>",
      "credential": "<string>",
      "gender": "<string>",
      "sole_proprietor": "<string>",
      "organization_name": "<string>",
      "organizational_subpart": "<string>",
      "parent_organization_name": "<string>",
      "status": "<string>",
      "enumeration_date": "<string>",
      "certification_date": "<string>",
      "authorized_official": {
        "@type": "NpiAuthorizedOfficial",
        "first_name": "<string>",
        "last_name": "<string>",
        "middle_name": "<string>",
        "name_prefix": "<string>",
        "name_suffix": "<string>",
        "credential": "<string>",
        "official_title": "<string>",
        "phone": "<string>"
      }
    },
    "addresses": [],
    "practice_locations": [],
    "taxonomies": [],
    "identifiers": [],
    "other_names": [],
    "endpoints": []
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required

Max number of results to return

Required range: 1 <= x <= 1200
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
enumeration_type
enum<string> | null

Restrict to individual providers (NPI-1) or organizations (NPI-2)

Available options:
NPI-1,
NPI-2
first_name
string | null

Provider first name. Add a trailing * for prefix matching, otherwise the value is matched exactly.

last_name
string | null

Provider last name. Add a trailing * for prefix matching, otherwise the value is matched exactly.

organization_name
string | null

Organization name. Add a trailing * for prefix matching, otherwise the value is matched exactly.

taxonomy_description
string | null

Provider specialty / taxonomy description

Example:

"dentist"

city
string | null

City of the provider address

state
enum<string> | null

US state or territory of the provider address

Available options:
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
postal_code
string | null

Postal (ZIP) code. Add a trailing * for prefix matching, otherwise the value is matched exactly.

country_code
string | null

2-letter country code of the provider address

Example:

"US"

address_purpose
enum<string> | null

Which address the city/state/postal_code filters apply to

Available options:
LOCATION,
MAILING,
PRIMARY,
SECONDARY
name_purpose
enum<string> | null

Match first_name/last_name against the provider (PROVIDER) or authorized official (AO)

Available options:
AO,
PROVIDER
use_first_name_alias
boolean | null

Also match known aliases and variants of first_name

Response

Successful Response

number
string
required
@type
string
default:NpiProvider
enumeration_type
string | null
created_at
integer | null
updated_at
integer | null
basic
object | null
addresses
object[]
practice_locations
object[]
taxonomies
object[]
identifiers
object[]
other_names
object[]
endpoints
object[]