💡 Cache reference data. Most of these lists rarely change. Load them once (or on a schedule) and reuse them, instead of looking them up on every request. Remember that IDs differ between sandbox and production.
Standard codes
These lists are the same for every NikoHealth customer.
Data | Endpoint | Filters | Example |
HCPCS / CPT codes |
|
|
|
Modifiers |
|
|
|
Places of service |
|
|
|
Countries |
|
|
|
Hospitals |
|
| Name, address, and phone |
Medications |
|
| Name, ingredient, form, and dosage |
Payer adjustment groups |
|
|
|
Payer adjustment reasons |
|
|
|
Payer remark codes |
|
|
|
Provider-level adjustments |
|
|
|
Payment methods |
|
|
|
Payment levels |
|
|
|
Eligibility service types |
|
|
|
Most of these lists are large (for example, thousands of hospitals and over 100,000 medications). Always filter and page through them.
Your Organization's Setup
These records are specific to your environment.
Organization
Data | Endpoint | Key filters |
Your organization |
|
|
Service locations |
|
|
Billing providers |
|
|
Rendering providers |
|
|
Users |
|
|
Teams |
|
|
Team members |
|
|
Payers and Pricing
Data | Endpoint | Key filters |
Payers |
|
|
Payer plans |
|
|
Price options |
|
|
Pricing groups |
|
|
Product tax codes |
|
|
Clinical
Data | Endpoint | Key filters |
Referring providers |
|
|
Inventory and Products
Data | Endpoint | Key filters |
Products |
|
|
Vendors |
|
|
Inventory locations (warehouses) |
|
|
Units of measure |
|
|
Product categories / groups / manufacturers |
|
|
Drop-ship accounts |
|
|
Tags, Types, and Categories
Data | Endpoint |
Patient tags |
|
Order tags |
|
Invoice tags |
|
Document tags |
|
Document types |
|
Note subjects |
|
Task categories |
|
Purchase order statuses |
|
Custom fields |
|
Webhook event types |
|
ID Formats at a Glance
Knowing the format helps you spot when the wrong kind of ID is being sent.
Record | Format | Example |
Patient | Numeric |
|
Order |
|
|
Order item |
|
|
Patient insurance |
|
|
Invoice |
|
|
Invoice insurance |
|
|
Payment |
|
|
Prescription |
|
|
Referring provider |
|
|
Referring provider location |
|
|
Service location |
|
|
Billing provider |
|
|
Product | 20 characters |
|
Payer / payer plan | 40 characters |
|
Patient document | Numeric |
|
Document Management file |
|
|
Custom field |
|
|
Task |
|
|
Vendor |
|
|
Diagnosis | ICD-10 code with dot |
|
⚠️ Some prefixes are shared. Rental programs also start with RP (like referring providers), and inventory locations and DropDown list items both start with LI.
Always check which kind of record an ID belongs to.
