Skip to main content
Python
import requests

url = 'https://api.simplex.sh/pa_enroll_provider'
headers = {
    'Authorization': 'Bearer your_api_key_here',
    'Content-Type': 'application/json'
}
data = {
    'portal': 'uhc',
    'credential_name': 'my_uhc_creds',
    'provider': {
        'first_name': 'Jane',
        'last_name': 'Smith',
        'middle_name': '',
        'suffix': '',
        'date_of_birth': '1980-06-15',
        'gender': 'female',
        'ssn': '123-45-6789',
        'npi': 1234567890,
        'profession': 'MD',
        'primary_specialty': 'internal_medicine',
        'primary_taxonomy': '207R00000X',
        'ethnicity': 'not_hispanic_latino',
        'race': ['white'],
        'birth_city': 'Chicago',
        'birth_country': 'US',
        'us_citizen': True,
        'us_graduated': True
    },
    'contact': {
        'primary_phone': '555-867-5309',
        'secondary_email': '',
        'communication_preference': ['TEXT'],
        'address': {
            'line_1': '456 Medical Center Dr',
            'line_2': 'Suite 200',
            'city': 'Houston',
            'state': 'TX',
            'postal_code': '77001',
            'country': 'US'
        }
    },
    'employment': {
        'type': 'full_time',
        'title': '',
        'start_date': '2024-03-19',
        'care_delivery_setting': 'clinic_based'
    },
    'licensing': {
        'is_prescribing': True,
        'has_dea_certificate': True,
        'is_dea_eligible': True,
        'medicaid_id': '',
        'medicare_ptan': ''
    },
    'credentialing': {
        'caqh_number': '12345678',
        'credentialing_status': 'not_requested',
        'background_check_status': 'not_requested',
        'verification_status': 'in_progress',
        'has_caqh_management': True
    },
    'agreements': {
        'esignature_consent': True,
        'esignature_name': 'Jane Smith',
        'caqh_esignature_consent': True,
        'caqh_esignature_name': 'Jane Smith',
        'caqh_attestation_date': '2025-03-27'
    }
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(f"Enrollment submitted: {result['success']}")
print(f"Enrollment ID: {result['enrollment_id']}")
{
  "success": true,
  "enrollment_id": "<string>",
  "status": "submitted"
}
Enroll a provider with a payer portal. Submits provider demographic, licensing, and credentialing information to initiate or update enrollment.
Portal credentials required. You must first store credentials for the target portal using Create Credential and reference them via credential_name.
This endpoint transmits sensitive PII including SSN and date of birth. All data is encrypted in transit and at rest.

Authorizations

X-API-Key
string
header
required

Simplex API Key

Body

application/json
portal
enum<string>
required

The payer portal to enroll with (e.g. "uhc").

Available options:
uhc
credential_name
string
required

The name of the stored credential to authenticate with the portal. Create one via the Create Credential endpoint.

provider
object
required

Provider identity and demographic information.

contact
object
required

Contact information and address.

employment
object
required

Employment details.

agreements
object
required

E-signature and attestation details.

licensing
object

Licensing and prescribing information.

credentialing
object

CAQH credentialing information.

Response

200 - application/json

Provider enrollment response

success
boolean
required

Whether the enrollment was submitted successfully.

enrollment_id
string
required

Unique identifier for the enrollment submission.

status
enum<string>
required

Current status of the enrollment.

Available options:
submitted,
pending_review,
in_progress