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
| Endpoint | Description |
|---|---|
POST /estimate | Real-time cost estimate & benefit details for a patient's session |
POST /discover | Find active coverage and plan-level details for a patient; knowing the patient's insurer |
POST /scan | Scan multiple payers to find any patient's active coverage |
POST /medicaid | Find 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())Updated 15 days ago

