API Reference

import requests

headers = {"X-Api-Key": "YOUR_API_KEY"}
r = requests.get(
    "https://api.providerdownload.com/v1/providers/1234567890",
    headers=headers
)
print(r.json())

const res = await fetch("https://api.providerdownload.com/v1/providers/1234567890", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);

const https = require("https");

const options = {
  hostname: "api.providerdownload.com",
  path: "/v1/providers/1234567890",
  headers: { "X-Api-Key": "YOUR_API_KEY" }
};

https.get(options, res => {
  let body = "";
  res.on("data", chunk => body += chunk);
  res.on("end", () => console.log(JSON.parse(body)));
});

<?php
$ch = curl_init("https://api.providerdownload.com/v1/providers/1234567890");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Api-Key", "YOUR_API_KEY");
var response = await client.GetStringAsync(
    "https://api.providerdownload.com/v1/providers/1234567890");
Console.WriteLine(response);

import requests

headers = {"X-Api-Key": "YOUR_API_KEY"}
r = requests.get(
    "https://api.providerdownload.com/v1/providers/1003000118",
    headers=headers
)
provider = r.json()
print(provider["first_name"], provider["last_name"])

const res = await fetch("https://api.providerdownload.com/v1/providers/1003000118", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
const provider = await res.json();
console.log(provider.first_name, provider.last_name);

const https = require("https");

https.get({
  hostname: "api.providerdownload.com",
  path: "/v1/providers/1003000118",
  headers: { "X-Api-Key": "YOUR_API_KEY" }
}, res => {
  let body = "";
  res.on("data", c => body += c);
  res.on("end", () => console.log(JSON.parse(body)));
});

<?php
$npi = "1003000118";
$ch = curl_init("https://api.providerdownload.com/v1/providers/{$npi}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
echo $data["first_name"] . " " . $data["last_name"];

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Api-Key", "YOUR_API_KEY");
var json = await client.GetStringAsync(
    "https://api.providerdownload.com/v1/providers/1003000118");
Console.WriteLine(json);

import requests

r = requests.get(
    "https://api.providerdownload.com/v1/providers",
    headers={"X-Api-Key": "YOUR_API_KEY"},
    params={"name": "smith", "first_name": "john", "state": "FL", "limit": 10}
)
results = r.json()
for p in results["results"]:
    print(p["npi"], p.get("first_name"), p.get("last_name") or p.get("organization_name"))

const params = new URLSearchParams({ name: "smith", first_name: "john", state: "FL", limit: 10 });
const res = await fetch(`https://api.providerdownload.com/v1/providers?${params}`, {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
const { results } = await res.json();
results.forEach(p => console.log(p.npi, p.first_name, p.last_name || p.organization_name));

const https = require("https");
const qs = require("querystring");

const query = qs.stringify({ specialty: "cardiology", state: "FL", limit: 10 });
https.get({
  hostname: "api.providerdownload.com",
  path: `/v1/providers?${query}`,
  headers: { "X-Api-Key": "YOUR_API_KEY" }
}, res => {
  let body = "";
  res.on("data", c => body += c);
  res.on("end", () => console.log(JSON.parse(body)));
});

<?php
$params = http_build_query(["specialty" => "cardiology", "state" => "FL", "limit" => 10]);
$ch = curl_init("https://api.providerdownload.com/v1/providers?{$params}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);
$results = json_decode(curl_exec($ch), true);
curl_close($ch);
foreach ($results as $p) {
    echo $p["npi"] . "\n";
}

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Api-Key", "YOUR_API_KEY");
var url = "https://api.providerdownload.com/v1/providers?specialty=cardiology&state=FL&limit=10";
var json = await client.GetStringAsync(url);
Console.WriteLine(json);

import requests

r = requests.post(
    "https://api.providerdownload.com/v1/bulk/lookup",
    headers={"X-Api-Key": "YOUR_API_KEY"},
    json={
        "npis": ["1003000118", "1003001074"],
        "include": ["taxonomy"]
    }
)
for provider in r.json():
    print(provider["npi"], provider.get("taxonomy"))

const res = await fetch("https://api.providerdownload.com/v1/bulk/lookup", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    npis: ["1003000118", "1003001074"],
    include: ["taxonomy"]
  })
});
const results = await res.json();
results.forEach(p => console.log(p.npi, p.taxonomy));

const https = require("https");

const body = JSON.stringify({
  npis: ["1003000118", "1003001074"],
  include: ["taxonomy"]
});

const req = https.request({
  hostname: "api.providerdownload.com",
  path: "/v1/bulk/lookup",
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
    "Content-Length": Buffer.byteLength(body)
  }
}, res => {
  let data = "";
  res.on("data", c => data += c);
  res.on("end", () => console.log(JSON.parse(data)));
});
req.write(body);
req.end();

<?php
$payload = json_encode([
    "npis"    => ["1003000118", "1003001074"],
    "include" => ["taxonomy"]
]);
$ch = curl_init("https://api.providerdownload.com/v1/bulk/lookup");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-Api-Key: YOUR_API_KEY",
    "Content-Type: application/json"
]);
$results = json_decode(curl_exec($ch), true);
curl_close($ch);
foreach ($results as $p) {
    echo $p["npi"] . "\n";
}

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Api-Key", "YOUR_API_KEY");

var payload = new {
    npis    = new[] { "1003000118", "1003001074" },
    include = new[] { "taxonomy" }
};
var content = new StringContent(
    System.Text.Json.JsonSerializer.Serialize(payload),
    System.Text.Encoding.UTF8,
    "application/json"
);
var response = await client.PostAsync(
    "https://api.providerdownload.com/v1/bulk/lookup", content);
Console.WriteLine(await response.Content.ReadAsStringAsync());

r = requests.get(
    "https://api.providerdownload.com/v1/providers/1003000118/taxonomy",
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
for code in r.json():
    print(code["code"], code["display_name"], "primary:", code["primary"])

const res = await fetch("https://api.providerdownload.com/v1/providers/1003000118/taxonomy", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
const codes = await res.json();
codes.forEach(c => console.log(c.code, c.display_name));

https.get({
  hostname: "api.providerdownload.com",
  path: "/v1/providers/1003000118/taxonomy",
  headers: { "X-Api-Key": "YOUR_API_KEY" }
}, res => {
  let body = "";
  res.on("data", c => body += c);
  res.on("end", () => console.log(JSON.parse(body)));
});

<?php
$ch = curl_init("https://api.providerdownload.com/v1/providers/1003000118/taxonomy");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);
$codes = json_decode(curl_exec($ch), true);
curl_close($ch);
foreach ($codes as $c) {
    echo $c["code"] . " " . $c["display_name"] . "\n";
}

var json = await client.GetStringAsync(
    "https://api.providerdownload.com/v1/providers/1003000118/taxonomy");
Console.WriteLine(json);

r = requests.get(
    "https://api.providerdownload.com/v1/providers/1003000118/locations",
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
for loc in r.json():
    print(loc["address_line1"], loc["city"], loc["state"])

const res = await fetch("https://api.providerdownload.com/v1/providers/1003000118/locations", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
const locations = await res.json();
locations.forEach(l => console.log(l.address_line1, l.city, l.state));

https.get({
  hostname: "api.providerdownload.com",
  path: "/v1/providers/1003000118/locations",
  headers: { "X-Api-Key": "YOUR_API_KEY" }
}, res => {
  let body = "";
  res.on("data", c => body += c);
  res.on("end", () => console.log(JSON.parse(body)));
});

<?php
$ch = curl_init("https://api.providerdownload.com/v1/providers/1003000118/locations");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);
$locs = json_decode(curl_exec($ch), true);
curl_close($ch);
foreach ($locs as $l) {
    echo $l["address_line1"] . ", " . $l["city"] . "\n";
}

var json = await client.GetStringAsync(
    "https://api.providerdownload.com/v1/providers/1003000118/locations");
Console.WriteLine(json);

r = requests.get(
    "https://api.providerdownload.com/v1/providers/1003000118/endpoints",
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
print(r.json())

const res = await fetch("https://api.providerdownload.com/v1/providers/1003000118/endpoints", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
console.log(await res.json());

https.get({
  hostname: "api.providerdownload.com",
  path: "/v1/providers/1003000118/endpoints",
  headers: { "X-Api-Key": "YOUR_API_KEY" }
}, res => {
  let body = "";
  res.on("data", c => body += c);
  res.on("end", () => console.log(JSON.parse(body)));
});

<?php
$ch = curl_init("https://api.providerdownload.com/v1/providers/1003000118/endpoints");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);
print_r(json_decode(curl_exec($ch), true));
curl_close($ch);

var json = await client.GetStringAsync(
    "https://api.providerdownload.com/v1/providers/1003000118/endpoints");
Console.WriteLine(json);

r = requests.get(
    "https://api.providerdownload.com/v1/providers/1003000118/names",
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
print(r.json())

const res = await fetch("https://api.providerdownload.com/v1/providers/1003000118/names", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
console.log(await res.json());

https.get({
  hostname: "api.providerdownload.com",
  path: "/v1/providers/1003000118/names",
  headers: { "X-Api-Key": "YOUR_API_KEY" }
}, res => {
  let body = "";
  res.on("data", c => body += c);
  res.on("end", () => console.log(JSON.parse(body)));
});

<?php
$ch = curl_init("https://api.providerdownload.com/v1/providers/1003000118/names");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);
print_r(json_decode(curl_exec($ch), true));
curl_close($ch);

var json = await client.GetStringAsync(
    "https://api.providerdownload.com/v1/providers/1003000118/names");
Console.WriteLine(json);

r = requests.get(
    "https://api.providerdownload.com/v1/providers/changes",
    headers={"X-Api-Key": "YOUR_API_KEY"},
    params={"limit": 50}
)
print(r.json())

const res = await fetch("https://api.providerdownload.com/v1/providers/changes?limit=50", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
console.log(await res.json());

https.get({
  hostname: "api.providerdownload.com",
  path: "/v1/providers/changes?limit=50",
  headers: { "X-Api-Key": "YOUR_API_KEY" }
}, res => {
  let body = "";
  res.on("data", c => body += c);
  res.on("end", () => console.log(JSON.parse(body)));
});

<?php
$ch = curl_init("https://api.providerdownload.com/v1/providers/changes?limit=50");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);
print_r(json_decode(curl_exec($ch), true));
curl_close($ch);

var json = await client.GetStringAsync(
    "https://api.providerdownload.com/v1/providers/changes?limit=50");
Console.WriteLine(json);

r = requests.get(
    "https://api.providerdownload.com/v1/providers/deactivated",
    headers={"X-Api-Key": "YOUR_API_KEY"},
    params={"limit": 50}
)
print(r.json())

const res = await fetch("https://api.providerdownload.com/v1/providers/deactivated?limit=50", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
console.log(await res.json());

https.get({
  hostname: "api.providerdownload.com",
  path: "/v1/providers/deactivated?limit=50",
  headers: { "X-Api-Key": "YOUR_API_KEY" }
}, res => {
  let body = "";
  res.on("data", c => body += c);
  res.on("end", () => console.log(JSON.parse(body)));
});

<?php
$ch = curl_init("https://api.providerdownload.com/v1/providers/deactivated?limit=50");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);
print_r(json_decode(curl_exec($ch), true));
curl_close($ch);

var json = await client.GetStringAsync(
    "https://api.providerdownload.com/v1/providers/deactivated?limit=50");
Console.WriteLine(json);

r = requests.get(
    "https://api.providerdownload.com/account/me",
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
account = r.json()
print(f"Plan: {account['plan']}")
print(f"Used: {account['monthly_used']} / {account['monthly_limit']}")
if account.get("quota_warning"):
    print(f"Warning: {account['quota_warning']}")

const res = await fetch("https://api.providerdownload.com/account/me", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
const account = await res.json();
console.log(`Plan: ${account.plan}`);
console.log(`Used: ${account.monthly_used} / ${account.monthly_limit}`);
if (account.quota_warning) console.warn(account.quota_warning);

https.get({
  hostname: "api.providerdownload.com",
  path: "/account/me",
  headers: { "X-Api-Key": "YOUR_API_KEY" }
}, res => {
  let body = "";
  res.on("data", c => body += c);
  res.on("end", () => {
    const account = JSON.parse(body);
    console.log(`Plan: ${account.plan}, Used: ${account.monthly_used}`);
  });
});

<?php
$ch = curl_init("https://api.providerdownload.com/account/me");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);
$account = json_decode(curl_exec($ch), true);
curl_close($ch);
echo "Plan: " . $account["plan"] . "\n";
echo "Used: " . $account["monthly_used"] . " / " . $account["monthly_limit"] . "\n";

var json = await client.GetStringAsync(
    "https://api.providerdownload.com/account/me");
Console.WriteLine(json);

import requests
r = requests.post("https://api.providerdownload.com/auth/resend-key",
                  json={"email": "you@example.com"})
print(r.json()["message"])

await fetch("https://api.providerdownload.com/auth/resend-key", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "you@example.com" }),
});

import requests
r = requests.post("https://api.providerdownload.com/account/rotate-key",
                  headers={"X-Api-Key": "your_api_key"})
new_key = r.json()["api_key"]
print(new_key)

const res = await fetch("https://api.providerdownload.com/account/rotate-key", {
  method: "POST",
  headers: { "X-Api-Key": "your_api_key" },
});
const { api_key } = await res.json();
console.log("New key:", api_key);

import requests, webbrowser
r = requests.post("https://api.providerdownload.com/account/portal",
                  headers={"X-Api-Key": "your_api_key"})
webbrowser.open(r.json()["url"])

const res = await fetch("https://api.providerdownload.com/account/portal", {
  method: "POST",
  headers: { "X-Api-Key": "your_api_key" },
});
const { url } = await res.json();
window.location.href = url;

const crypto = require("crypto");

function verify(secret, body, signature) {
  const expected = "sha256=" + crypto
    .createHmac("sha256", secret)
    .update(body)
    .digest("hex");
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}

<?php
function verifyWebhook(string $secret, string $body, string $signature): bool {
    $expected = "sha256=" . hash_hmac("sha256", $body, $secret);
    return hash_equals($expected, $signature);
}

using System.Security.Cryptography;
using System.Text;

bool Verify(string secret, byte[] body, string signature) {
    using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(secret));
    var hash = "sha256=" + Convert.ToHexString(hmac.ComputeHash(body)).ToLower();
    return CryptographicOperations.FixedTimeEquals(
        Encoding.UTF8.GetBytes(hash),
        Encoding.UTF8.GetBytes(signature));
}

import requests

r = requests.post(
    "https://api.providerdownload.com/v1/webhooks/subscriptions",
    headers={"X-Api-Key": "YOUR_API_KEY"},
    json={
        "url":           "https://your-server.com/webhooks/nppes",
        "events":        ["npi.deactivated", "npi.name_changed"],
        "filter_states": ["FL"],
    }
)
sub = r.json()
print("ID:",     sub["id"])
print("Secret:", sub["secret"])  # store this — shown once

const res = await fetch("https://api.providerdownload.com/v1/webhooks/subscriptions", {
  method: "POST",
  headers: { "X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    url:           "https://your-server.com/webhooks/nppes",
    events:        ["npi.deactivated", "npi.name_changed"],
    filter_states: ["FL"],
  })
});
const sub = await res.json();
console.log("Secret:", sub.secret); // store this — shown once