API Documentation | Cognizant Cloud LLC

Authentication

All API requests can be made without authentication for testing. For production use, include your API key to track credits and access higher rate limits.

1

Create an Account

Sign up at cognizantcloud.com/account. New accounts receive 50 free credits to get started.

2

Generate an API Key

Go to cognizantcloud.com/api-keys to create and manage your API keys. You can generate multiple keys for different projects.

3

Include the Key in Requests

Pass your API key in the x-api-key header with every request.

x-api-key: your_api_key_here

Test Your Key

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=provider/search&last_name=smith&state=NY&limit=1"

javascript

const response = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=provider/search&last_name=smith&state=NY&limit=1",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const data = await response.json();
console.log("Credits remaining:", response.headers.get("X-Credits-Remaining"));
console.log(data);

python

import requests

response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"endpoint": "provider/search", "last_name": "smith", "state": "NY", "limit": 1}
)
print("Credits remaining:", response.headers.get("X-Credits-Remaining"))
print(response.json())

Key rotation: Generate a new key before revoking the old one. Update your application to use the new key, verify it works, then revoke the old key from the API Keys dashboard. Never share keys in client-side code or public repositories.

Quick Start

Make your first API call in seconds. No API key required for testing.

bash

# Search for providers named Smith in New York
curl "https://cognizantcloud.com/api/v1/?endpoint=provider/search&last_name=smith&state=NY"

# Check drug interactions for metformin
curl "https://cognizantcloud.com/api/v1/?endpoint=drug/interactions&drug=metformin"

# Look up ICD-10 codes for diabetes
curl "https://cognizantcloud.com/api/v1/?endpoint=diagnosis/icd10&query=diabetes"

javascript

// Search for providers named Smith in New York
const response = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=provider/search&last_name=smith&state=NY"
);
const data = await response.json();
console.log(data.data.result_count, "providers found");

python

import requests

# Search for providers named Smith in New York
response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    params={"endpoint": "provider/search", "last_name": "smith", "state": "NY"}
)
data = response.json()
print(f"{data['data']['result_count']} providers found")

The API returns JSON with provider data, response time, and credit usage. All endpoints accept GET with query parameters or POST with a JSON body.

Base URL

Base URL https://cognizantcloud.com/api/v1/

All endpoints use query parameters. Pass the endpoint parameter to select a data source, then add endpoint-specific parameters. The API accepts both GET and POST methods. For POST requests, send parameters as a JSON body.

Response Headers

Every response includes these custom headers for monitoring and debugging:

Header	Description
X-Auth	Authentication status: `authenticated` or `anonymous`
X-Credits-Used	Number of credits consumed by this request
X-Credits-Remaining	Credits remaining on your account (authenticated only)
X-Response-Time	Server-side processing time in milliseconds
X-Endpoint	The endpoint that was called
X-Rate-Limit	Your per-key rate limit (authenticated only)
X-Powered-By	Always returns `Cognizant Cloud API v1`

Provider Endpoints

GETprovider/search Search the NPPES database of 8M+ healthcare providers 1 credit

Parameters

Parameter	Type	Description
first_name optional	string	Provider first name (supports alias matching by default)
last_name optional	string	Provider last name
organization_name optional	string	Organization name (Type 2 NPIs)
state optional	string	Two-letter state code (e.g., NY, CA)
city optional	string	City name
postal_code optional	string	ZIP code (5-digit)
taxonomy_description optional	string	Provider specialty (e.g., "Family Medicine", "Cardiology")
enumeration_type optional	string	`NPI-1` (individual) or `NPI-2` (organization)
use_first_name_alias optional	boolean	Enable alias matching for first names (default: true). "Bill" matches "William".
limit optional	integer	Max results (default: 10, max: 200)

Code Examples

bash

# Search by name and state
curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=provider/search&last_name=smith&state=NY&limit=3"

# Search by specialty and city
curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=provider/search&taxonomy_description=Cardiology&city=Boston&state=MA"

# Search organizations only
curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=provider/search&organization_name=mayo+clinic&enumeration_type=NPI-2"

javascript

const params = new URLSearchParams({
  endpoint: "provider/search",
  last_name: "smith",
  state: "NY",
  taxonomy_description: "Family Medicine",
  limit: "5"
});

const response = await fetch(
  `https://cognizantcloud.com/api/v1/?${params}`,
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);

const { data, credits_used, response_time_ms } = await response.json();
console.log(`Found ${data.result_count} providers in ${response_time_ms}ms`);

for (const provider of data.results) {
  console.log(`${provider.basic.first_name} ${provider.basic.last_name}, ${provider.basic.credential}`);
}

python

import requests

response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "endpoint": "provider/search",
        "last_name": "smith",
        "state": "NY",
        "taxonomy_description": "Family Medicine",
        "limit": 5
    }
)

data = response.json()
for provider in data["data"]["results"]:
    basic = provider["basic"]
    print(f"{basic['first_name']} {basic['last_name']}, {basic.get('credential', 'N/A')}")

Example Response

json

{
  "endpoint": "provider/search",
  "credits_used": 1,
  "auth": "authenticated",
  "response_time_ms": 142,
  "data": {
    "result_count": 3,
    "results": [
      {
        "number": 1234567890,
        "basic": {
          "first_name": "JOHN",
          "last_name": "SMITH",
          "credential": "MD",
          "gender": "M",
          "enumeration_date": "2005-06-15",
          "last_updated": "2024-01-10",
          "status": "A"
        },
        "addresses": [
          {
            "address_purpose": "LOCATION",
            "city": "NEW YORK",
            "state": "NY",
            "postal_code": "100211234",
            "telephone_number": "212-555-0100"
          }
        ],
        "taxonomies": [
          {
            "code": "207Q00000X",
            "desc": "Family Medicine",
            "primary": true,
            "state": "NY",
            "license": "123456"
          }
        ]
      }
    ]
  }
}

Field	Type	Description
data.result_count	integer	Number of providers in this response
data.results[]	array	Array of provider objects from NPPES
results[].number	integer	10-digit NPI number
results[].basic.first_name	string	Provider first name (uppercase)
results[].basic.last_name	string	Provider last name (uppercase)
results[].basic.credential	string	Provider credential (MD, DO, NP, etc.)
results[].basic.gender	string	M or F
results[].basic.enumeration_date	string	Date NPI was assigned (YYYY-MM-DD)
results[].basic.status	string	"A" for active
results[].addresses[]	array	Location and mailing addresses
results[].taxonomies[]	array	Provider specialties and licenses
taxonomies[].desc	string	Specialty description
taxonomies[].primary	boolean	Whether this is the primary taxonomy

Try It

Live

Last Name

First Name

State

Specialty

Limit

Response

Fill in parameters and click Send Request

GETprovider/lookup Look up a single provider by NPI number 1 credit

Parameters

Parameter	Type	Description
npi required	string	10-digit National Provider Identifier

Code Examples

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=provider/lookup&npi=1234567890"

javascript

const response = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=provider/lookup&npi=1234567890",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const { data } = await response.json();
const provider = data.results[0];
console.log(provider.basic.first_name, provider.basic.last_name);

python

import requests

response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"endpoint": "provider/lookup", "npi": "1234567890"}
)
provider = response.json()["data"]["results"][0]
print(provider["basic"]["first_name"], provider["basic"]["last_name"])

Field	Type	Description
data.result_count	integer	Always 1 for a valid NPI
data.results[0]	object	Full NPPES provider record (same structure as provider/search)
results[0].number	integer	The requested NPI number
results[0].basic	object	Name, credential, gender, status, dates
results[0].addresses	array	Practice and mailing addresses
results[0].taxonomies	array	Specialties and state license info
results[0].identifiers	array	Other provider identifiers
results[0].other_names	array	Former names or aliases

Try It

Live

NPI Number *

Response

Fill in parameters and click Send Request

Drug Endpoints

GETdrug/interactions Get drug-drug interaction data via RxNorm. Resolves drug name to RxCUI, then retrieves all known interactions. 2 credits

Parameters

Parameter	Type	Description
drug required	string	Drug name, brand or generic (e.g., "metformin", "Lipitor")

Code Examples

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=drug/interactions&drug=metformin"

javascript

const response = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=drug/interactions&drug=metformin",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const { data } = await response.json();
console.log("RxCUI:", data.rxcui);
console.log("Interactions:", data.interactions);

python

import requests

response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"endpoint": "drug/interactions", "drug": "metformin"}
)
data = response.json()["data"]
print(f"RxCUI: {data['rxcui']}")
print(f"Found {len(data.get('interactions', {}))} interaction groups")

Example Response

json

{
  "endpoint": "drug/interactions",
  "credits_used": 2,
  "auth": "authenticated",
  "response_time_ms": 234,
  "data": {
    "rxcui": "6809",
    "drug": "metformin",
    "interactions": {
      "interactionTypeGroup": [
        {
          "sourceName": "DrugBank",
          "interactionType": [
            {
              "interactionPair": [
                {
                  "interactionConcept": [
                    { "minConceptItem": { "rxcui": "6809", "name": "metformin" } },
                    { "minConceptItem": { "rxcui": "4815", "name": "insulin" } }
                  ],
                  "severity": "N/A",
                  "description": "Metformin may enhance the hypoglycemic effect of Insulin."
                }
              ]
            }
          ]
        }
      ]
    }
  }
}

Field	Type	Description
data.rxcui	string	RxNorm Concept Unique Identifier for the drug
data.drug	string	The drug name you searched for
data.interactions	object	Full interaction data from RxNorm API
interactions.interactionTypeGroup[]	array	Grouped by source (DrugBank, ONCHigh)
interactionType[].interactionPair[]	array	Each interacting drug pair
interactionPair[].description	string	Clinical description of the interaction
interactionPair[].severity	string	Severity level (varies by source)

Try It

Live

Drug Name *

Response

Fill in parameters and click Send Request

GETdrug/label Retrieve FDA-approved drug labeling from openFDA, including indications, warnings, dosage, and contraindications 1 credit

Parameters

Parameter	Type	Description
drug required	string	Drug brand name (e.g., "lisinopril", "Tylenol")
limit optional	integer	Max results (default: 1). Increase if a brand has multiple formulations.

Code Examples

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=drug/label&drug=lisinopril"

javascript

const response = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=drug/label&drug=lisinopril",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const { data } = await response.json();
const label = data.results[0];
console.log("Indications:", label.indications_and_usage);
console.log("Warnings:", label.warnings);

python

import requests

response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"endpoint": "drug/label", "drug": "lisinopril"}
)
label = response.json()["data"]["results"][0]
print("Indications:", label.get("indications_and_usage", ["N/A"])[0][:200])

Field	Type	Description
data.results[]	array	Array of drug label records from openFDA
results[].indications_and_usage	string[]	FDA-approved indications
results[].dosage_and_administration	string[]	Dosing information
results[].warnings	string[]	Safety warnings
results[].adverse_reactions	string[]	Known adverse reactions
results[].contraindications	string[]	Conditions where drug should not be used
results[].drug_interactions	string[]	Known drug-drug interactions from label
results[].openfda.brand_name	string[]	Brand names
results[].openfda.generic_name	string[]	Generic names
results[].openfda.manufacturer_name	string[]	Manufacturer names

Try It

Live

Drug Name *

Limit

Response

Fill in parameters and click Send Request

GETdrug/adverse-events Search the FDA Adverse Event Reporting System (FAERS) for adverse event reports 2 credits

Parameters

Parameter	Type	Description
drug required	string	Drug name (brand or generic)
limit optional	integer	Max results (default: 10, max: 100)

Code Examples

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=drug/adverse-events&drug=atorvastatin&limit=5"

javascript

const response = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=drug/adverse-events&drug=atorvastatin&limit=5",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const { data } = await response.json();
for (const event of data.results) {
  const reactions = event.patient.reaction.map(r => r.reactionmeddrapt);
  console.log("Reactions:", reactions.join(", "));
}

python

import requests

response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"endpoint": "drug/adverse-events", "drug": "atorvastatin", "limit": 5}
)
for event in response.json()["data"]["results"]:
    reactions = [r["reactionmeddrapt"] for r in event["patient"]["reaction"]]
    print("Reactions:", ", ".join(reactions))

Field	Type	Description
data.results[]	array	FAERS adverse event reports
results[].safetyreportid	string	Unique FAERS report identifier
results[].serious	string	"1" if the event was serious
results[].patient.reaction[]	array	Reported adverse reactions
reaction[].reactionmeddrapt	string	MedDRA preferred term for the reaction
results[].patient.drug[]	array	Drugs the patient was taking
drug[].medicinalproduct	string	Drug name as reported
drug[].drugcharacterization	string	"1"=suspect, "2"=concomitant, "3"=interacting

Try It

Live

Drug Name *

Limit

Response

Fill in parameters and click Send Request

GETdrug/recalls Search FDA drug recall enforcement reports by drug name or free text 1 credit

Parameters

Parameter	Type	Description
drug optional	string	Drug name to filter recalls. Searches both reason_for_recall and brand_name.
search optional	string	Free-text search across recall records (alternative to drug filter)
limit optional	integer	Max results (default: 10, max: 100)

Code Examples

bash

# Search recalls by drug name
curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=drug/recalls&drug=metformin&limit=3"

# Search recalls by text (contamination, mislabeling, etc.)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=drug/recalls&search=contamination&limit=5"

javascript

const response = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=drug/recalls&drug=metformin&limit=3",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const { data } = await response.json();
for (const recall of data.results) {
  console.log(`[${recall.classification}] ${recall.reason_for_recall}`);
}

python

import requests

response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"endpoint": "drug/recalls", "drug": "metformin", "limit": 3}
)
for recall in response.json()["data"]["results"]:
    print(f"[{recall['classification']}] {recall['reason_for_recall'][:100]}")

Field	Type	Description
data.results[]	array	FDA enforcement/recall records
results[].recall_number	string	FDA recall number (e.g., D-1234-2026)
results[].classification	string	Class I (most serious), Class II, Class III
results[].reason_for_recall	string	Description of why the product was recalled
results[].status	string	Ongoing, Completed, Terminated
results[].product_description	string	Description of the recalled product
results[].recalling_firm	string	Company initiating the recall
results[].voluntary_mandated	string	Whether recall was voluntary or mandated

Try It

Live

Drug Name

Search Text

Limit

Response

Fill in parameters and click Send Request

GETdrug/ndc Look up drugs by National Drug Code or brand name via the openFDA NDC directory 1 credit

Parameters

Parameter	Type	Description
ndc optional	string	National Drug Code (e.g., "0069-1520-30"). Provide either ndc or drug.
drug optional	string	Drug brand name to search for
limit optional	integer	Max results (default: 10)

Code Examples

bash

# Look up by drug name
curl "https://cognizantcloud.com/api/v1/?endpoint=drug/ndc&drug=lipitor&limit=3"

# Look up by NDC code
curl "https://cognizantcloud.com/api/v1/?endpoint=drug/ndc&ndc=0069-1520-30"

javascript

const response = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=drug/ndc&drug=lipitor&limit=3",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const { data } = await response.json();
for (const drug of data.results) {
  console.log(`${drug.brand_name} (${drug.product_ndc}) - ${drug.dosage_form}`);
}

python

import requests

response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"endpoint": "drug/ndc", "drug": "lipitor", "limit": 3}
)
for drug in response.json()["data"]["results"]:
    print(f"{drug['brand_name']} ({drug['product_ndc']}) - {drug['dosage_form']}")

Try It

Live

NDC Code

Drug Name

Limit

Response

Fill in parameters and click Send Request

GETdrug/rxnorm Resolve drug names to RxNorm identifiers, concepts, and related clinical drug information 1 credit

Parameters

Parameter	Type	Description
drug required	string	Drug name to look up in RxNorm (e.g., "amoxicillin")

Code Examples

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=drug/rxnorm&drug=amoxicillin"

javascript

const response = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=drug/rxnorm&drug=amoxicillin",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const { data } = await response.json();
const concepts = data.drugGroup?.conceptGroup || [];
for (const group of concepts) {
  if (group.conceptProperties) {
    for (const drug of group.conceptProperties) {
      console.log(`${drug.name} (RxCUI: ${drug.rxcui}, TTY: ${drug.tty})`);
    }
  }
}

python

import requests

response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"endpoint": "drug/rxnorm", "drug": "amoxicillin"}
)
data = response.json()["data"]
for group in data.get("drugGroup", {}).get("conceptGroup", []):
    for drug in group.get("conceptProperties", []):
        print(f"{drug['name']} (RxCUI: {drug['rxcui']}, TTY: {drug['tty']})")

Field	Type	Description
data.drugGroup.name	string	The drug name you searched
data.drugGroup.conceptGroup[]	array	Grouped by term type (SBD, SCD, etc.)
conceptGroup[].tty	string	Term type: SBD=branded, SCD=clinical, IN=ingredient
conceptGroup[].conceptProperties[]	array	Drug concepts in this group
conceptProperties[].rxcui	string	RxNorm Concept Unique Identifier
conceptProperties[].name	string	Full drug name with dose and form
conceptProperties[].tty	string	Term type for this concept

Try It

Live

Drug Name *

Response

Fill in parameters and click Send Request

GETdrug/pricing Get drug pricing data, NDC codes, packaging details, and manufacturer information 2 credits

Parameters

Parameter	Type	Description
drug optional	string	Drug brand name (e.g., "lipitor"). Provide either drug or ndc.
ndc optional	string	National Drug Code (e.g., "0069-1520-30")
limit optional	integer	Max results (default: 10, max: 100)

Code Examples

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=drug/pricing&drug=lipitor&limit=3"

javascript

const response = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=drug/pricing&drug=lipitor&limit=3",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const { data } = await response.json();
for (const product of data.results) {
  console.log(`${product.brand_name} by ${product.labeler_name}`);
  for (const pkg of product.packaging) {
    console.log(`  ${pkg.package_ndc}: ${pkg.description}`);
  }
}

python

import requests

response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"endpoint": "drug/pricing", "drug": "lipitor", "limit": 3}
)
for product in response.json()["data"]["results"]:
    print(f"{product['brand_name']} by {product['labeler_name']}")
    for pkg in product["packaging"]:
        print(f"  {pkg['package_ndc']}: {pkg['description']}")

Example Response

json

{
  "endpoint": "drug/pricing",
  "credits_used": 2,
  "auth": "authenticated",
  "response_time_ms": 198,
  "data": {
    "query": "lipitor",
    "result_count": 3,
    "results": [
      {
        "brand_name": "LIPITOR",
        "generic_name": "Atorvastatin Calcium",
        "labeler_name": "Pfizer Laboratories",
        "product_ndc": "0071-0155",
        "product_type": "HUMAN PRESCRIPTION DRUG",
        "route": ["ORAL"],
        "dosage_form": "TABLET, FILM COATED",
        "packaging": [
          {
            "package_ndc": "0071-0155-23",
            "description": "90 TABLET, FILM COATED in 1 BOTTLE",
            "marketing_start_date": "19970101"
          }
        ],
        "active_ingredients": [
          { "name": "ATORVASTATIN CALCIUM", "strength": "10 mg" }
        ],
        "marketing_category": "NDA"
      }
    ]
  }
}

Field	Type	Description
data.query	string	The drug name or NDC you searched
data.result_count	integer	Number of products found
data.results[]	array	Drug product records
results[].brand_name	string	Brand name (uppercase)
results[].generic_name	string	Generic/chemical name
results[].labeler_name	string	Manufacturer or labeler
results[].product_ndc	string	Product-level NDC code
results[].product_type	string	Rx, OTC, etc.
results[].route	string[]	Administration routes (ORAL, TOPICAL, etc.)
results[].dosage_form	string	TABLET, CAPSULE, SOLUTION, etc.
results[].packaging[]	array	Package configurations with package-level NDCs
results[].active_ingredients[]	array	Active ingredients with name and strength
results[].dea_schedule	string	DEA schedule if controlled substance
results[].marketing_category	string	NDA, ANDA, OTC, etc.

Try It

Live

Drug Name

NDC Code

Limit

Response

Fill in parameters and click Send Request

Diagnosis Endpoints

GETdiagnosis/icd10 Look up ICD-10-CM diagnosis codes by keyword or partial code via the NLM Clinical Tables API 1 credit

Parameters

Parameter	Type	Description
query required	string	Search term: diagnosis name ("diabetes"), partial code ("E11"), or exact code ("E11.9")
limit optional	integer	Max results (default: 10, max: 100)

Code Examples

bash

# Search by diagnosis name
curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=diagnosis/icd10&query=diabetes&limit=5"

# Search by partial ICD-10 code
curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=diagnosis/icd10&query=E11&limit=10"

javascript

const response = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=diagnosis/icd10&query=diabetes&limit=5",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const { data } = await response.json();
console.log(`${data.total_results} total matches`);
for (const code of data.results) {
  console.log(`${code.code}: ${code.description}`);
}

python

import requests

response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"endpoint": "diagnosis/icd10", "query": "diabetes", "limit": 5}
)
data = response.json()["data"]
print(f"{data['total_results']} total matches")
for code in data["results"]:
    print(f"{code['code']}: {code['description']}")

Example Response

json

{
  "endpoint": "diagnosis/icd10",
  "credits_used": 1,
  "auth": "authenticated",
  "response_time_ms": 95,
  "data": {
    "query": "diabetes",
    "total_results": 142,
    "results": [
      { "code": "E11.9", "description": "Type 2 diabetes mellitus without complications" },
      { "code": "E10.9", "description": "Type 1 diabetes mellitus without complications" },
      { "code": "E11.65", "description": "Type 2 diabetes mellitus with hyperglycemia" },
      { "code": "E11.22", "description": "Type 2 diabetes mellitus with diabetic chronic kidney disease" },
      { "code": "E13.9", "description": "Other specified diabetes mellitus without complications" }
    ]
  }
}

Field	Type	Description
data.query	string	The search term you used
data.total_results	integer	Total matching codes in the ICD-10-CM database
data.results[]	array	Array of matching ICD-10-CM codes
results[].code	string	ICD-10-CM code (e.g., E11.9)
results[].description	string	Full description of the diagnosis

Try It

Live

Search Term *

Limit

Response

Fill in parameters and click Send Request

Hospital Endpoints

GET / POSThospital/quality Search CMS Hospital Compare data including star ratings, quality measures, and facility details for 4,000+ US hospitals. Data refreshed from CMS CSV source with server-side caching. 2 credits

Parameters

Parameter	Type	Description
hospital_name optional	string	Hospital or facility name (partial match, case-insensitive)
state optional	string	Two-letter state code. Provide at least one filter (hospital_name, state, city, or zip).
city optional	string	Filter by city name (partial match, case-insensitive)
zip optional	string	Filter by ZIP code (exact match)
hospital_type optional	string	Filter by hospital type (e.g., "Acute Care Hospitals", "Critical Access Hospitals")
limit optional	integer	Max results (default: 10, max: 1000)

Code Examples

bash

# Search by hospital name and state
curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=hospital/quality&state=NY&hospital_name=mount+sinai&limit=5"

# POST with JSON body
curl -X POST -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"CA","measure":"readmission","limit":10}' \
  "https://cognizantcloud.com/api/v1/?endpoint=hospital/quality"

javascript

// GET request
const response = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=hospital/quality&state=NY&hospital_name=mount+sinai&limit=5",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);

// POST request (alternative)
const response2 = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=hospital/quality",
  {
    method: "POST",
    headers: { "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" },
    body: JSON.stringify({ state: "CA", measure: "readmission", limit: 10 })
  }
);

python

import requests

# GET request
response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"endpoint": "hospital/quality", "state": "NY", "hospital_name": "mount sinai"}
)

# POST request (alternative)
response = requests.post(
    "https://cognizantcloud.com/api/v1/?endpoint=hospital/quality",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"state": "CA", "measure": "readmission", "limit": 10}
)

Example Response

json

{
  "endpoint": "hospital/quality",
  "credits_used": 2,
  "auth": "authenticated",
  "response_time_ms": 312,
  "data": {
    "count": 5,
    "results": [
      {
        "facility_name": "MOUNT SINAI HOSPITAL",
        "state": "NY",
        "measure_name": "Mortality national comparison",
        "compared_to_national": "No Different Than the National Rate",
        "score": "Not Available",
        "footnote": "Results are based on a shorter time period than required."
      }
    ]
  }
}

Field	Type	Description
data.count	integer	Number of quality measure records returned
data.results[]	array	CMS Hospital Compare quality measure records
results[].facility_name	string	Hospital name (uppercase)
results[].state	string	State abbreviation
results[].measure_name	string	Quality measure being reported
results[].compared_to_national	string	Performance vs. national benchmark
results[].score	string	Numeric score if available
results[].footnote	string	CMS footnotes or caveats

Try It

Live

Hospital Name

State

Measure

Limit

Response

Fill in parameters and click Send Request

GET / POSThospital/hcahps Patient experience survey scores (HCAHPS) including communication, responsiveness, cleanliness, and overall hospital rating. Real-time CMS data with 1hr cache. 2 credits

Parameters

Parameter	Type	Description
provider_id optional	string	CMS Provider ID (6-digit facility number)
state optional	string	Two-letter state code
hospital_name optional	string	Hospital name (partial match)
limit optional	integer	Max results (default: 10, max: 500)

Code Examples

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=hospital/hcahps&state=NY&limit=5"

Try It

Live

State

Hospital Name

Provider ID

Limit

Response

Fill in parameters and click Send Request

GET / POSThospital/infections Healthcare-associated infection (HAI) data including CLABSI, CAUTI, SSI, MRSA, and C.diff rates compared to national benchmarks. Real-time CMS data with 1hr cache. 2 credits

Parameters

Parameter	Type	Description
provider_id optional	string	CMS Provider ID
state optional	string	Two-letter state code
hospital_name optional	string	Hospital name (partial match)
limit optional	integer	Max results (default: 10, max: 500)

Code Examples

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=hospital/infections&state=CA&limit=5"

Try It

Live

State

Hospital Name

Provider ID

Limit

Response

Fill in parameters and click Send Request

GET / POSThospital/complications Complication and death rates for heart attack, heart failure, pneumonia, hip/knee replacement, and other serious conditions. Real-time CMS data with 1hr cache. 2 credits

Parameters

Parameter	Type	Description
provider_id optional	string	CMS Provider ID
state optional	string	Two-letter state code
hospital_name optional	string	Hospital name (partial match)
limit optional	integer	Max results (default: 10, max: 500)

Code Examples

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=hospital/complications&state=TX&limit=5"

Try It

Live

State

Hospital Name

Provider ID

Limit

Response

Fill in parameters and click Send Request

GET / POSThospital/readmissions Unplanned readmission and mortality rates for heart attack, heart failure, pneumonia, COPD, stroke, CABG, and hip/knee replacement. Real-time CMS data with 1hr cache. 2 credits

Parameters

Parameter	Type	Description
provider_id optional	string	CMS Provider ID
state optional	string	Two-letter state code
hospital_name optional	string	Hospital name (partial match)
limit optional	integer	Max results (default: 10, max: 500)

Code Examples

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=hospital/readmissions&state=FL&limit=5"

Try It

Live

State

Hospital Name

Provider ID

Limit

Response

Fill in parameters and click Send Request

GET / POSThospital/spending Medicare spending per beneficiary (MSPB) data showing how hospital episode costs compare to the national median across claim types. Real-time CMS data with 1hr cache. 2 credits

Parameters

Parameter	Type	Description
provider_id optional	string	CMS Provider ID
state optional	string	Two-letter state code
hospital_name optional	string	Hospital name (partial match)
limit optional	integer	Max results (default: 10, max: 500)

Code Examples

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=hospital/spending&state=IL&limit=5"

Try It

Live

State

Hospital Name

Provider ID

Limit

Response

Fill in parameters and click Send Request

GET / POSThospital/timely-care Timely and effective care measures including ED wait times, sepsis treatment, blood clot prevention, immunization rates, and other process-of-care metrics. Real-time CMS data with 1hr cache. 2 credits

Parameters

Parameter	Type	Description
provider_id optional	string	CMS Provider ID
state optional	string	Two-letter state code
hospital_name optional	string	Hospital name (partial match)
limit optional	integer	Max results (default: 10, max: 500)

Code Examples

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=hospital/timely-care&state=PA&limit=5"

Try It

Live

State

Hospital Name

Provider ID

Limit

Response

Fill in parameters and click Send Request

GET / POSThospital/profile General hospital information including address, phone, type, ownership, emergency services, overall star rating, and mortality/safety/readmission national comparisons. Real-time CMS data with 1hr cache. 2 credits

Parameters

Parameter	Type	Description
provider_id optional	string	CMS Provider ID
state optional	string	Two-letter state code
hospital_name optional	string	Hospital name (partial match)
city optional	string	Filter by city name
zip optional	string	Filter by ZIP code
limit optional	integer	Max results (default: 10, max: 500)

Code Examples

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=hospital/profile&state=MA&city=boston&limit=5"

Try It

Live

State

City

Hospital Name

Provider ID

Limit

Response

Fill in parameters and click Send Request

Clinical Endpoints

GETtrials/search Search ClinicalTrials.gov (v2 API) by condition, intervention, status, or trial phase 2 credits

Parameters

Parameter	Type	Description
condition optional	string	Disease or condition (e.g., "diabetes", "breast cancer")
intervention optional	string	Drug, device, or procedure name
status optional	string	Trial status: `RECRUITING`, `COMPLETED`, `ACTIVE_NOT_RECRUITING`, `NOT_YET_RECRUITING`
phase optional	string	Trial phase: `PHASE1`, `PHASE2`, `PHASE3`, `PHASE4`
limit optional	integer	Max results (default: 10, max: 50)

Code Examples

bash

# Find recruiting Phase 3 diabetes trials
curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=trials/search&condition=diabetes&status=RECRUITING&phase=PHASE3&limit=5"

# Search by intervention (drug name)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://cognizantcloud.com/api/v1/?endpoint=trials/search&intervention=pembrolizumab&status=RECRUITING"

javascript

const params = new URLSearchParams({
  endpoint: "trials/search",
  condition: "diabetes",
  status: "RECRUITING",
  phase: "PHASE3",
  limit: "5"
});

const response = await fetch(
  `https://cognizantcloud.com/api/v1/?${params}`,
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const { data } = await response.json();
for (const study of data.studies) {
  const info = study.protocolSection?.identificationModule;
  console.log(`${info?.nctId}: ${info?.briefTitle}`);
}

python

import requests

response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "endpoint": "trials/search",
        "condition": "diabetes",
        "status": "RECRUITING",
        "phase": "PHASE3",
        "limit": 5
    }
)
for study in response.json()["data"]["studies"]:
    info = study["protocolSection"]["identificationModule"]
    print(f"{info['nctId']}: {info['briefTitle']}")

Example Response

json

{
  "endpoint": "trials/search",
  "credits_used": 2,
  "auth": "authenticated",
  "response_time_ms": 287,
  "data": {
    "totalCount": 1432,
    "studies": [
      {
        "protocolSection": {
          "identificationModule": {
            "nctId": "NCT06123456",
            "briefTitle": "A Phase 3 Study of Novel GLP-1 Receptor Agonist..."
          },
          "statusModule": {
            "overallStatus": "RECRUITING"
          },
          "designModule": {
            "phases": ["PHASE3"],
            "enrollmentInfo": { "count": 850 }
          },
          "conditionsModule": {
            "conditions": ["Type 2 Diabetes Mellitus"]
          }
        }
      }
    ]
  }
}

Field	Type	Description
data.totalCount	integer	Total matching trials on ClinicalTrials.gov
data.studies[]	array	Array of clinical trial records
studies[].protocolSection	object	Main trial data structure
identificationModule.nctId	string	ClinicalTrials.gov identifier (NCT number)
identificationModule.briefTitle	string	Short title of the trial
statusModule.overallStatus	string	Current recruitment status
designModule.phases	string[]	Trial phase(s)
designModule.enrollmentInfo.count	integer	Target enrollment
conditionsModule.conditions	string[]	Conditions being studied
armsInterventionsModule	object	Treatment arms and interventions
contactsLocationsModule	object	Study sites and contact information

Try It

Live

Condition

Intervention

Status

Phase

Limit

Response

Fill in parameters and click Send Request

Live API Tester

Test any endpoint directly from your browser. Responses come from the live production API. You can also use the "Try It" section within each endpoint above.

API Explorer

Connected

Endpoint

Response

Select an endpoint and click "Send Request" to see live results.

Error Codes

The API uses standard HTTP status codes. All error responses include a JSON body with an error field describing the problem.

400Bad Request

Missing required parameters or invalid parameter format. Check the endpoint documentation for required fields.

json

{
  "error": "drug parameter required"
}

401Unauthorized

Your API key is missing, invalid, or has been revoked. Verify your key at cognizantcloud.com/api-keys.

json

{
  "error": "Invalid or revoked API key"
}

402Payment Required

Your account does not have enough credits for this request. Purchase more credits at cognizantcloud.com/pricing.

json

{
  "error": "Insufficient credits",
  "credits_remaining": 0,
  "credits_required": 2,
  "upgrade_url": "https://cognizantcloud.com/pricing"
}

403Forbidden

Your API key is valid but access is denied. This can occur if your key has been disabled by an admin or your account has been suspended.

json

{
  "error": "User account not found for this API key"
}

404Not Found

The endpoint you requested does not exist. The response includes a list of valid endpoints.

json

{
  "error": "Unknown endpoint: drug/fake",
  "available": [
    "provider/search", "provider/lookup", "drug/interactions",
    "drug/label", "drug/adverse-events", "drug/recalls",
    "drug/ndc", "drug/rxnorm", "drug/pricing",
    "diagnosis/icd10", "hospital/quality", "trials/search"
  ]
}

429Too Many Requests

You have exceeded your rate limit. Wait until the reset time or upgrade your plan for higher limits.

json

{
  "error": "rate_limit_exceeded",
  "message": "You have exceeded your daily API call limit.",
  "limit": 100,
  "reset_at": "2026-04-03T00:00:00Z"
}

500Internal Server Error

An unexpected error occurred on the server, typically from an upstream API failure (NPPES, openFDA, etc.). If this persists, contact support@cognizantcloud.com.

json

{
  "error": "Upstream API error: 503",
  "endpoint": "provider/search"
}

Error handling best practice: Always check the HTTP status code first. For 5xx errors, implement exponential backoff with a maximum of 3 retries. For 402 errors, check the X-Credits-Remaining header proactively to avoid hitting zero. For 429 errors, respect the reset_at timestamp.

Rate Limits

Rate limits are applied per API key for authenticated requests, or per IP address for unauthenticated requests. Exceeding your limit returns HTTP 429.

Free

100

calls / day

Pro

5,000

calls / day

Ultra

50,000

calls / day

Rate Limit Headers

Authenticated responses include these headers to help you track usage:

Header	Description
X-Rate-Limit	Your maximum allowed calls per day
X-Credits-Remaining	Credits remaining in your account after this call
X-Credits-Used	Credits consumed by this specific request

Handling Rate Limits

javascript

async function apiCall(endpoint, params, retries = 3) {
  const url = new URL("https://cognizantcloud.com/api/v1/");
  url.searchParams.set("endpoint", endpoint);
  for (const [k, v] of Object.entries(params)) url.searchParams.set(k, v);

  for (let i = 0; i < retries; i++) {
    const response = await fetch(url, {
      headers: { "x-api-key": "YOUR_API_KEY" }
    });

    // Check credits proactively
    const remaining = response.headers.get("X-Credits-Remaining");
    if (remaining !== null && parseInt(remaining) < 10) {
      console.warn(`Low credits: ${remaining} remaining`);
    }

    if (response.status === 429) {
      const delay = Math.pow(2, i) * 1000; // exponential backoff
      console.log(`Rate limited. Retrying in ${delay}ms...`);
      await new Promise(r => setTimeout(r, delay));
      continue;
    }

    return await response.json();
  }
  throw new Error("Max retries exceeded");
}

python

import requests, time

def api_call(endpoint, params, retries=3):
    params["endpoint"] = endpoint
    for i in range(retries):
        response = requests.get(
            "https://cognizantcloud.com/api/v1/",
            headers={"x-api-key": "YOUR_API_KEY"},
            params=params
        )

        # Check credits proactively
        remaining = response.headers.get("X-Credits-Remaining")
        if remaining and int(remaining) < 10:
            print(f"Warning: only {remaining} credits remaining")

        if response.status_code == 429:
            delay = (2 ** i)  # exponential backoff
            print(f"Rate limited. Retrying in {delay}s...")
            time.sleep(delay)
            continue

        response.raise_for_status()
        return response.json()

    raise Exception("Max retries exceeded")

Rate limits vs. credits: Rate limits cap how many API calls you can make per day. Credits determine how many total calls you can make before purchasing more. You can hit a rate limit even if you have credits remaining. Upgrade your subscription tier to increase rate limits.

Pagination

Most endpoints support a limit parameter that controls how many results are returned per request. The maximum limit varies by endpoint, based on upstream API constraints.

Endpoint	Default	Maximum	Upstream Source
provider/search	10	200	NPPES API
drug/adverse-events	10	100	openFDA FAERS
drug/recalls	10	100	openFDA Enforcement
drug/ndc	10	100	openFDA NDC Directory
drug/pricing	10	100	openFDA NDC Directory
diagnosis/icd10	10	100	NLM Clinical Tables
hospital/quality	10	100	CMS Hospital Compare
trials/search	10	50	ClinicalTrials.gov v2

Paginating Through Large Result Sets

For endpoints that return a total_results or totalCount field larger than your limit, make multiple requests with different criteria to cover the full dataset. For the ICD-10 endpoint, the total_results field tells you how many total codes matched your query.

javascript

// Fetch providers in batches of 200 (maximum per request)
async function getAllProviders(state, specialty) {
  const response = await fetch(
    `https://cognizantcloud.com/api/v1/?endpoint=provider/search&state=${state}&taxonomy_description=${specialty}&limit=200`,
    { headers: { "x-api-key": "YOUR_API_KEY" } }
  );
  const { data } = await response.json();
  console.log(`Retrieved ${data.result_count} of ${data.result_count} providers`);
  return data.results;
}

// For ICD-10, check total_results to know the full count
const { data } = await fetch(
  "https://cognizantcloud.com/api/v1/?endpoint=diagnosis/icd10&query=diabetes&limit=100",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
).then(r => r.json());
console.log(`Got ${data.data.results.length} of ${data.data.total_results} total matches`);

python

import requests

# Fetch max providers per request
response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"endpoint": "provider/search", "state": "NY", "taxonomy_description": "Cardiology", "limit": 200}
)
data = response.json()["data"]
print(f"Retrieved {data['result_count']} providers")

# For ICD-10, check total_results to see full count
response = requests.get(
    "https://cognizantcloud.com/api/v1/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"endpoint": "diagnosis/icd10", "query": "diabetes", "limit": 100}
)
data = response.json()["data"]
print(f"Got {len(data['results'])} of {data['total_results']} total matches")

Pagination strategy: Use more specific search parameters (adding state, specialty, city) to narrow results rather than paginating through thousands of records. This is faster, uses fewer credits, and returns more relevant data. For broad searches, the total_results field tells you how many records exist so you can refine your query.

Response Format

Every successful response follows a consistent envelope structure, making it simple to build reliable integrations regardless of which endpoint you call.

json

{
  "endpoint": "provider/search",      // which endpoint was called
  "credits_used": 1,                   // credits consumed (0 if unauthenticated)
  "auth": "authenticated",             // "authenticated" or "anonymous"
  "response_time_ms": 142,              // server-side processing time
  "data": { /* endpoint-specific payload */ }
}

endpoint

Echoes the endpoint you requested. Useful for logging and debugging.

credits_used

Credits deducted for this call. 0 for anonymous (unauthenticated) requests.

auth

Whether the request was authenticated with a valid API key.

response_time_ms

Server-side processing time in milliseconds. Does not include network transit.

data

The response payload. Structure varies by endpoint (see schemas above).

Credit Costs by Endpoint

Endpoint	Credits
provider/search	1 credit per call
provider/lookup	1 credit per call
drug/interactions	2 credits per call
drug/label	1 credit per call
drug/adverse-events	2 credits per call
drug/recalls	1 credit per call
drug/ndc	1 credit per call
drug/rxnorm	1 credit per call
drug/pricing	2 credits per call
diagnosis/icd10	1 credit per call
hospital/quality	2 credits per call
trials/search	2 credits per call

Healthcare Data API

Authentication

Create an Account

Generate an API Key

Include the Key in Requests

Test Your Key

Quick Start

Base URL

Response Headers

Provider Endpoints

Parameters

Code Examples

Example Response

Try It

Parameters

Code Examples

Try It

Drug Endpoints

Parameters

Code Examples

Example Response

Try It

Parameters

Code Examples

Try It

Parameters

Code Examples

Try It

Parameters

Code Examples

Try It

Parameters

Code Examples

Try It

Parameters

Code Examples

Try It

Parameters

Code Examples

Example Response

Try It

Diagnosis Endpoints

Parameters

Code Examples

Example Response

Try It

Hospital Endpoints

Parameters

Code Examples

Example Response

Try It

Parameters

Code Examples

Try It

Parameters

Code Examples

Try It

Parameters

Code Examples

Try It

Parameters

Code Examples

Try It

Parameters

Code Examples

Try It

Parameters

Code Examples

Try It

Parameters

Code Examples

Try It

Clinical Endpoints

Parameters

Code Examples

Example Response

Try It

Live API Tester

API Explorer

Error Codes