{ "openapi": "3.0.1", "info": { "title": "NPI Registry - Healthcare Provider Search", "description": "Search the official NPPES NPI Registry for healthcare providers, physicians, and organizations. Look up by NPI number, name, specialty, or location. Perfect for healthcare marketing, provider verification, credentialing, and medical data enrichment.", "version": "1.0", "x-build-id": "bISeOmmrLdRY4ZKmX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~npi-registry---healthcare-provider-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-npi-registry---healthcare-provider-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/alizarin_refrigerator-owner~npi-registry---healthcare-provider-search/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-npi-registry---healthcare-provider-search", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/alizarin_refrigerator-owner~npi-registry---healthcare-provider-search/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-npi-registry---healthcare-provider-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "task" ], "properties": { "task": { "title": "Task", "enum": [ "search_providers", "lookup_npi", "search_organizations", "search_by_specialty", "search_by_location", "batch_lookup" ], "type": "string", "description": "Operation to perform", "default": "search_providers" }, "npiNumber": { "title": "NPI Number", "type": "string", "description": "Exact 10-digit NPI number to look up" }, "firstName": { "title": "First Name", "type": "string", "description": "Provider first name (for individual providers)" }, "lastName": { "title": "Last Name", "type": "string", "description": "Provider last name (for individual providers)" }, "organizationName": { "title": "Organization Name", "type": "string", "description": "Organization name (for organizational providers)" }, "taxonomyDescription": { "title": "Taxonomy/Specialty", "type": "string", "description": "Provider specialty or taxonomy description (e.g., 'Family Medicine', 'Cardiology')" }, "city": { "title": "City", "type": "string", "description": "City for location-based search" }, "state": { "title": "State", "type": "string", "description": "Two-letter state code (e.g., CA, NY, TX)" }, "postalCode": { "title": "Postal Code", "type": "string", "description": "ZIP code for location-based search" }, "countryCode": { "title": "Country Code", "type": "string", "description": "Country code (default: US)", "default": "US" }, "enumerationType": { "title": "Enumeration Type", "enum": [ "NPI-1", "NPI-2" ], "type": "string", "description": "Type of NPI to search" }, "addressPurpose": { "title": "Address Purpose", "enum": [ "LOCATION", "MAILING", "PRIMARY", "SECONDARY" ], "type": "string", "description": "Filter by address type" }, "npiNumbers": { "title": "NPI Numbers (Batch)", "type": "array", "description": "Array of NPI numbers for batch lookup", "default": [] }, "limit": { "title": "Limit", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of results to return (max 200)", "default": 50 }, "skip": { "title": "Skip", "minimum": 0, "type": "integer", "description": "Number of results to skip (for pagination)", "default": 0 }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL to send results to (Zapier, Make, n8n, etc.)" }, "demoMode": { "title": "Demo Mode", "type": "boolean", "description": "Run with sample data", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }