Overview
This content is intended for people with web development experience. Clients using our API are responsible for understanding this material.
If this is your first API integration with NikoHealth, start by getting familiar with the basics: RESTful APIs, authentication and the recommended best practices below.
NikoHealth uses RESTful APIs that exchange JSON over HTTPS. They give you a secure, reliable, flexible and scalable way to connect your systems to NikoHealth.
💡 Looking for a pre-built integration?
Clearinghouses, Parachute Health, RingCentral fax, CardConnect payments and drop-ship vendors connect to NikoHealth without any code.
You set them up in Management › Application Settings › Integrations.
Licensing and Costs
When you purchase an API subscription license, you receive:
A sandbox environment for developing and testing
API credentials: a Client ID and a Client Secret
Access to Swagger, where you can learn the API and try out requests
💲 Some endpoints, such as real-time insurance eligibility checks, have per-transaction fees on top of the license.
To learn more about the API subscription license, contact support@nikohealth.com.
Getting Started
Step | Article |
1. Understand how to authenticate | |
2. Check the technical requirements | |
3. Set up and try requests in the sandbox | |
4. Understand responses and errors |
Key Concepts
Base URL
https://{yourDomain}.nikohealth.com/api/externalEndpoints are versioned in the path, for example /v1/patients or /v2/....
Authentication: All requests use OAuth 2.0 Client Credentials. Exchange your Client ID and Client Secret for a bearer token, which lasts 20 minutes, and send it with every request.
Webhooks: Instead of polling, subscribe to events so NikoHealth notifies your system when something changes. See Webhooks API.
Lookups first: Most create requests need IDs that already exist in your environment, such as service locations, payers, products and referring providers. Use the GET lookup endpoints to get them before you post.
Common Workflows
Workflow | Article |
Create a patient | |
Add insurance to a patient | |
Check insurance eligibility | |
Create an order | |
Upload patient documents | |
Manage patient notes |
What APIs Are Available?
Browse every endpoint in the NikoHealth API reference (Swagger). To try requests, use the Swagger page in your own sandbox.
If you have any questions, contact us at support@nikohealth.com.
