API Reference
Providers
Create or update healthcare provider records via the Integration API.
Create or update healthcare provider (physician, NP, PA, etc.) records.
Upsert Provider
POST /integration/providersCreates or updates a provider by id.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Your unique identifier for this provider |
first_name | string | Yes | Provider's first name |
last_name | string | Yes | Provider's last name |
npi | string | No | National Provider Identifier (10 digits) |
email | string | No | Email address |
phone | string | No | Phone number |
role | string | No | Provider role (see values below) |
taxonomy_code | string | No | Healthcare provider taxonomy code |
specialty | string | No | Medical specialty (e.g., "Internal Medicine") |
address_line_1 | string | No | Street address |
address_line_2 | string | No | Address line 2 |
city | string | No | City |
state | string | No | State code |
zip_code | string | No | ZIP code |
country | string | No | Country code (default: US) |
Provider Roles
| Value | Description |
|---|---|
attending_physician | Attending/supervising physician |
rendering_provider | Provider who renders the service |
referring_provider | Provider who referred the patient |
billing_provider | Provider responsible for billing |
operating_physician | Surgeon/operating physician |
Example Request
curl -X POST https://api.neuralrev.ai/integration/providers \
-H "x-api-key: nrev_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": "PROV-001",
"first_name": "John",
"last_name": "Smith",
"npi": "1234567890",
"email": "dr.smith@clinic.example.com",
"phone": "5550100101",
"role": "attending_physician",
"taxonomy_code": "207R00000X",
"specialty": "Internal Medicine",
"address_line_1": "456 Medical Plaza",
"city": "Springfield",
"state": "IL",
"zip_code": "62701",
"country": "US"
}'Response
200 OK — Provider upserted successfully:
{
"success": true,
"message": "Provider upserted successfully"
}Notes
- The NPI is a 10-digit identifier required for claim submission. Provide it when available.
- Taxonomy codes follow the NUCC Health Care Provider Taxonomy Code Set.
- Reference providers in encounters using the same
idyou assigned here.