Overview

Nirvana API Overview

Our goal is to take the complexity out of insurance verification, so your team can focus on care, not coverage.

Nirvana’s API lets you verify a patient’s insurance eligibility, estimate their financial responsibility for any appointment, identify plan-level details that could lead to a denial, and recover active insurance using only basic demographic information. 🧠⚡

By normalizing complex payer data into structured, consistent JSON, Nirvana surfaces the details that matter most - to prevent denials before they happen, improve your patient conversion funnel, and confidently schedule more session knowing coverage & cost is handled by Nirvana


🔌 Endpoints

EndpointDescription
POST /estimateReal-time cost estimate & benefit details for a patient's session
POST /discoverFind active coverage and plan-level details for a patient; knowing the patient's insurer
POST /scanScan multiple payers to find any patient's active coverage
POST /medicaidFind active medicaid coverage & medicaid-level details for a patient

All responses are payer-normalized and returned in clean JSON.


💡 Use Cases

  • Show cost estimates at intake or appointment scheduling
  • Auto-verify coverage before care is rendered
  • Reduce claim denials with real-time benefit checks
  • Support RCM and billing teams with complete payer data

🔐 Authentication

All requests must include your API key in the Authorization header:

headers = {  
'apikey': "yourapikey",
'Content-Type': 'application/json'
}
curl --location 'https://coverage-api.meetnirvana.com/v1/estimate/' \
--header 'apikey: KEY' \
--header 'Content-Type: application/json' \
--data '{}'

🔑 Creating an API Key

Get Started with Nirvana

🛠️ Using your API Key

  • Contact Nirvana to set up an api key for you. The api key is required to make actual coverage calls.
  • The api key should be passed in as a header as “apikey”.
  • Sample curl request for your reference:
curl --location 'https://coverage-api.meetnirvana.com/v1/estimate/' \
--header 'apikey: KEY' \
--header 'Content-Type: application/json' \
--data '{
   "payer_id": "60054",
   "provider_npi": "1234567890",
   "member_id": "MEMBERID",
   "member_first_name": "",
   "member_last_name": "",
   "member_dob": "YYYY-MM-DD",
   "provider_first_name": "",
   "provider_last_name": "",
   "provider_session_cost": "20000",
   "in_network": true
}
import requests

url = "https://coverage-api.meetnirvana.com/v1/estimate"

headers = {
    "apikey": "[APIKEY]",
    "Content-Type": "application/json"
}

payload = {
    "payer_id": "60054",
    "provider_npi": "1234567890",
    "member_id": "MEMBERID",
    "member_first_name": "",
    "member_last_name": "",
    "member_dob": "YYYY-MM-DD",
    "provider_first_name": "",
    "provider_last_name": "",
    "provider_session_cost": "20000",
    "in_network": True
}

response = requests.post(url, headers=headers, json=payload)

print(response.status_code)
print(response.json())



Did this page help you?