{ "openapi": "3.0.1", "info": { "title": "NPI Registry Search & CMS Hospital, Nursing Home Lookup", "description": "Returns US healthcare organizations from the official NPI Registry (hospitals, clinics, pharmacies, labs, home health) by name, specialty, city, state or ZIP, or CMS Provider Data facilities (hospitals, nursing homes, hospice, dialysis) with ratings. Organizations only. No key.", "version": "0.1", "x-build-id": "a4H7trPZQNf5bqFPu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lathewright~healthcare-organizations/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lathewright-healthcare-organizations", "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/lathewright~healthcare-organizations/runs": { "post": { "operationId": "runs-sync-lathewright-healthcare-organizations", "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/lathewright~healthcare-organizations/run-sync": { "post": { "operationId": "run-sync-lathewright-healthcare-organizations", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "npiSearch", "npiLookup", "cmsProviders" ], "type": "string", "description": "`npiSearch` searches organizations in the NPI Registry. `npiLookup` fetches specific NPIs. `cmsProviders` lists Medicare-certified facilities of one type from CMS.", "default": "npiSearch" }, "organizationName": { "title": "Organization name", "type": "string", "description": "Name or prefix; `*` is a wildcard after at least two characters (e.g. `mayo*`). Used by npiSearch and cmsProviders." }, "taxonomyDescription": { "title": "Specialty / taxonomy (npiSearch)", "type": "string", "description": "NPI taxonomy description, e.g. `Hospital`, `Pharmacy`, `Clinic/Center`, `Home Health`, `Clinical Medical Laboratory`, `Dentist`, `Skilled Nursing Facility`, `Ambulatory Surgical`." }, "city": { "title": "City", "type": "string", "description": "City of the practice location (exact for NPI, contains for CMS)." }, "state": { "title": "State", "type": "string", "description": "Two-letter state code, e.g. `MN`." }, "postalCode": { "title": "ZIP / postal code", "type": "string", "description": "ZIP code; NPI accepts a wildcard (`902*`), CMS matches the 5-digit prefix." }, "addressPurpose": { "title": "Address purpose (npiSearch)", "enum": [ "", "LOCATION", "MAILING", "PRIMARY", "SECONDARY" ], "type": "string", "description": "Which address the city/state/ZIP filters apply to." }, "npis": { "title": "NPI numbers (npiLookup)", "type": "array", "description": "10-digit NPIs. Individual practitioners come back as error rows; only organizations (type 2) are returned.", "items": { "type": "string" } }, "providerType": { "title": "CMS provider type (cmsProviders)", "enum": [ "hospitals", "nursingHomes", "homeHealth", "hospice", "dialysis", "inpatientRehab", "longTermCareHospitals" ], "type": "string", "description": "Which CMS Provider Data Catalog dataset to list." }, "ownership": { "title": "Ownership (cmsProviders)", "type": "string", "description": "Substring of the ownership type, e.g. `non-profit`, `Government`, `Proprietary`, `For profit`." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap per run. Each organization is one billable event. The NPI API returns at most 1,200 results per query.", "default": 25 }, "compactOutput": { "title": "Compact output", "type": "boolean", "description": "Return only the key fields (smaller, cheaper for AI agents to read).", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }