license-verify-api 1.0.0

package/README.md

@@ -0,0 +1,78 @@
+# License Verify API
+
+JavaScript client for the [Healthcare License Verification API](https://rapidapi.com/lulzasaur9192/api/healthcare-license) on RapidAPI.
+
+Verify professional licenses across all 50 US states + DC. Supports 22 healthcare professions including nurses, doctors, dentists, pharmacists, therapists, and more.
+
+## Install
+
+```bash
+npm install license-verify-api
+```
+
+## Quick Start
+
+```javascript
+const LicenseVerifyClient = require('license-verify-api');
+
+const client = new LicenseVerifyClient('YOUR_RAPIDAPI_KEY');
+
+// Verify a nurse's license in California
+const result = await client.verify({
+  state: 'CA',
+  lastName: 'Johnson',
+  licenseType: 'RN',
+});
+console.log(result);
+
+// Direct NPI lookup
+const provider = await client.lookupNPI('1234567890');
+
+// Search by name
+const providers = await client.searchByName('Smith', 'TX', {
+  licenseType: 'MD',
+  limit: 10,
+});
+```
+
+## API Methods
+
+### `verify(options)`
+Search and verify healthcare professional licenses.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| state | string | US state code (e.g. "CA", "FL") |
+| lastName | string | Provider last name (required unless using npiNumber) |
+| firstName | string | Provider first name (optional) |
+| licenseType | string | License type filter (see supported types below) |
+| npiNumber | string | NPI number (alternative to name search) |
+| limit | number | Max results (default: 50) |
+
+### `lookupNPI(npi)`
+Direct lookup by 10-digit NPI number. Returns full provider details including taxonomies and practice locations.
+
+### `searchByName(lastName, state, options?)`
+Convenience method for name-based provider search.
+
+## Supported License Types
+
+MD, DO, RN, LPN, NP, APRN, CNA, PT, PTA, OT, OTA, SLP, CF, PSYCH, RPH, PHARMD, DDS, DMD, PA, DC, OD, DPM
+
+## Use Cases
+
+- **Staffing Agencies**: Verify nurse credentials before placement
+- **Background Checks**: Confirm professional license status
+- **HR Compliance**: Validate healthcare worker licenses at scale
+- **Credentialing**: Automate provider credentialing workflows
+- **Telemedicine**: Verify cross-state licensing for remote providers
+
+## Get Your API Key
+
+1. Go to [Healthcare License API on RapidAPI](https://rapidapi.com/lulzasaur9192/api/healthcare-license)
+2. Subscribe (free tier: 200 requests/month)
+3. Copy your API key from the dashboard
+
+## License
+
+MIT

package/index.d.ts

@@ -0,0 +1,23 @@
+interface VerifyOptions {
+  state: string;
+  lastName?: string;
+  firstName?: string;
+  licenseType?: string;
+  npiNumber?: string;
+  limit?: number;
+}
+
+interface SearchOptions {
+  firstName?: string;
+  licenseType?: string;
+  limit?: number;
+}
+
+declare class LicenseVerifyClient {
+  constructor(apiKey: string);
+  verify(options: VerifyOptions): Promise<any>;
+  lookupNPI(npi: string): Promise<any>;
+  searchByName(lastName: string, state: string, options?: SearchOptions): Promise<any>;
+}
+
+export = LicenseVerifyClient;

package/index.js

@@ -0,0 +1,70 @@
+'use strict';
+
+const BASE_URL = 'https://healthcare-license.p.rapidapi.com';
+
+class LicenseVerifyClient {
+  /**
+   * @param {string} apiKey - Your RapidAPI key (get one at https://rapidapi.com/lulzasaur9192/api/healthcare-license)
+   */
+  constructor(apiKey) {
+    if (!apiKey) throw new Error('API key required — get one at https://rapidapi.com/lulzasaur9192/api/healthcare-license');
+    this.apiKey = apiKey;
+    this.headers = {
+      'x-rapidapi-key': apiKey,
+      'x-rapidapi-host': 'healthcare-license.p.rapidapi.com',
+    };
+  }
+
+  async _request(path, params = {}) {
+    const url = new URL(BASE_URL + path);
+    for (const [k, v] of Object.entries(params)) {
+      if (v !== undefined && v !== null) url.searchParams.set(k, String(v));
+    }
+    const res = await fetch(url.toString(), { headers: this.headers });
+    if (!res.ok) {
+      const body = await res.text().catch(() => '');
+      throw new Error(`License Verify API error ${res.status}: ${body}`);
+    }
+    return res.json();
+  }
+
+  /**
+   * Verify a healthcare professional's license
+   * @param {Object} options
+   * @param {string} options.state - US state code (e.g. "CA", "FL", "TX")
+   * @param {string} [options.lastName] - Provider's last name (required unless using npiNumber)
+   * @param {string} [options.firstName] - Provider's first name
+   * @param {string} [options.licenseType] - License type (MD, DO, RN, LPN, NP, APRN, CNA, PT, PTA, OT, OTA, SLP, CF, PSYCH, RPH, PHARMD, DDS, DMD, PA, DC, OD, DPM)
+   * @param {string} [options.npiNumber] - NPI number (alternative to name search)
+   * @param {number} [options.limit=50] - Max results
+   * @returns {Promise<Object>}
+   */
+  async verify(options = {}) {
+    return this._request('/healthcare/verify', options);
+  }
+
+  /**
+   * Look up a provider by NPI number
+   * @param {string} npi - 10-digit NPI number
+   * @returns {Promise<Object>}
+   */
+  async lookupNPI(npi) {
+    return this._request(`/healthcare/npi/${encodeURIComponent(npi)}`);
+  }
+
+  /**
+   * Search for providers by name and state
+   * @param {string} lastName - Provider's last name
+   * @param {string} state - US state code
+   * @param {Object} [options]
+   * @param {string} [options.firstName] - First name
+   * @param {string} [options.licenseType] - License type filter
+   * @param {number} [options.limit=50] - Max results
+   * @returns {Promise<Object>}
+   */
+  async searchByName(lastName, state, options = {}) {
+    return this._request('/healthcare/verify', { lastName, state, ...options });
+  }
+}
+
+module.exports = LicenseVerifyClient;

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "license-verify-api",
+  "version": "1.0.0",
+  "description": "JavaScript client for Healthcare License Verification API — verify professional licenses across all 50 US states, NPI lookup, nurse/doctor/contractor license checks via RapidAPI",
+  "keywords": [
+    "license-verification",
+    "professional-license",
+    "nursing-license",
+    "healthcare",
+    "compliance",
+    "npi",
+    "nppes",
+    "background-check",
+    "api",
+    "rapidapi",
+    "hr-tech",
+    "credentialing"
+  ],
+  "main": "index.js",
+  "types": "index.d.ts",
+  "author": "lulzasaur9192",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lulzasaur9192/license-verify-api"
+  },
+  "homepage": "https://rapidapi.com/lulzasaur9192/api/healthcare-license",
+  "engines": {
+    "node": ">=14"
+  }
+}