Raw schema
{
"type": "object",
"properties": {
"enumeration_type": {
"description": "Restrict to 'NPI-1' (individuals) or 'NPI-2' (organizations). Omit to search both.",
"type": "string",
"enum": [
"NPI-1",
"NPI-2"
]
},
"number": {
"description": "Exact 10-digit NPI number.",
"type": "string",
"pattern": "^\\d{10}$"
},
"first_name": {
"description": "Individual provider first name (trailing '*' wildcard allowed).",
"type": "string"
},
"last_name": {
"description": "Individual provider last name (trailing '*' wildcard allowed).",
"type": "string"
},
"organization_name": {
"description": "Organization name (trailing '*' wildcard allowed).",
"type": "string"
},
"name_purpose": {
"description": "For name matching: 'PROVIDER' (default) or 'AO' (authorized official).",
"type": "string",
"enum": [
"AO",
"PROVIDER"
]
},
"taxonomy_description": {
"description": "Provider taxonomy / specialty text, e.g. 'cardiology', 'Pediatrics', 'Social Worker'. Partial matches supported; a trailing '*' wildcard is allowed (min 2 chars before it).",
"type": "string"
},
"city": {
"description": "City of the provider's address.",
"type": "string"
},
"state": {
"description": "Two-letter U.S. state/territory abbreviation, e.g. 'CA', 'NY', 'PR'.",
"type": "string"
},
"postal_code": {
"description": "Postal (ZIP) code; a trailing '*' wildcard is allowed for prefix search, e.g. '941*'.",
"type": "string"
},
"country_code": {
"description": "Two-letter country code (default 'US'). Use 'US' for domestic addresses.",
"type": "string"
},
"address_purpose": {
"description": "Which address the city/state/postal_code filters apply to (LOCATION = practice address).",
"type": "string",
"enum": [
"LOCATION",
"MAILING",
"PRIMARY",
"SECONDARY"
]
},
"limit": {
"description": "Max number of records to return (1โ200, default 10).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"skip": {
"description": "Number of records to skip, for pagination (0โ1000; combined with limit, up to 1200 records reachable).",
"type": "integer",
"minimum": 0,
"maximum": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}