Introduction

The Credentialing Genie API is organized around REST. Our API has predictable resource-oriented URLs, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Use the API to retrieve information about your dental companies, offices, and dentists. You can also track insurance credentialing statuses in real-time.

Authentication

The API uses a token-based authentication system. Most endpoints require an api_token to be passed in the Authorization header.

The Logic

First, obtain a token via the login endpoint using your credentials. This token is valid for 24 hours.

user string (required)
The email address associated with your API account.
password string (required)
Your secure API password.

Errors

Credentialing Genie uses standard HTTP codes to indicate overall request status. However, for multi-action calls, specific resource errors may be returned within the data object even if the primary response is successful.

400 - Bad Request
The request was unacceptable, often due to missing a required parameter or specifying an invalid action.
401 - Unauthorized
No valid API token or expired session.
429 - Too Many Requests
Exceeded the 300 requests/1 minutes limit.

Message: Too many requests. Please try again after 1 minutes.

Rate Limits

To ensure system stability, the API is limited to 300 requests per 1 minutes per IP address. Exceeding this limit will trigger a 429 error.

Pagination

Most lists retrieval endpoints provide a pagination object in the response. You can control the results via query parameters.

current_page integer
The page number to retrieve. Default: 1.
per_page integer
A limit on the number of objects to be returned. Default: 50.

Companies

GET /api/get_companies

Companies represent the top-level entity in your dental organization. A company can be a "single" office group or a "parent" group containing multiple children.

The Company Object

id integer
Unique identifier for the company.
nanoid string
Unique identifier used for search.
company_name string
The legal name of the dental company or group.
created_date timestamp
Unix timestamp representing when the company was created.
modified_date timestamp
Unix timestamp representing the last time the company record was updated.
entity_info object
A metadata object containing specific details depending on the company type.
company_dba_name string
The "Doing Business As" name.
tax_id_tin string
The Tax Identification Number (TIN).
group_npi string
The Group National Provider Identifier.
list_companies string
Only for groups. A comma-separated list of child company IDs.
office object
Provides a quick reference to the primary dental office associated with the company (if applicable). Includes id, nanoid, and name.

Create Company

POST /api/create_company

Endpoint to create a new company record. This endpoint is currently in Beta. Please contact support for access.

Offices

GET /api/get_offices

Offices represent physical dental practice locations. Each office belongs to a specific Company and contains lists of associated dentists and active insurance plans.

Base attributes

id integer
Unique identifier for the office.
nanoid string
Unique identifier used for search.
status string
Status of the office. 1: Active, 2: Inactive
created_date date string
Date and time when the office was registered.
modifi_date date string
The date and time of the last modification.

Business Identity

Practice_Name string
The official practice name used for billing and credentialing.
Legal_Business_name string
The legal name of the entity for tax purposes.
offices_code string
A unique group identifier used to categorize offices under specific dental networks or corporate groups (e.g., rosen, risas, ameridentco).
TAX_ID_Number string
The Tax Identification Number (TIN) for the office.
Group_NPI_Number string
The Group-level National Provider Identifier.

Location & Contact

Primary_Office_Address_full string
The complete street address, city, state, and zip for the primary location.
Primary_Office_Address_Office_Phone string
Primary contact phone number.
Primary_Office_Address_Hours array
A schedule of operating statuses (Open/Closed) and times for each day of the week.
Office_manager_email_address string
Primary contact email for the office management.

Owner & Professional Credentials

is_practice_owner_dentist string
Indicates if the practice owner is a dentist. If "yes", the following professional credentials are provided:
Owner_license_number string
State dental license number of the owner.
Owner_license_expiration_date date
Expiration date of the state dental license.
Owner_license_dea_license_number string
The owner's Federal DEA registration number.
Owner_license_dea_expiration_date date
Expiration date of the DEA registration.
Owner_dentist_specialty string
Primary clinical specialty (e.g., General Dentistry, Orthodontics).
Owner_NPI string
Individual National Provider Identifier.
Owner_degree_awarded_dmd / dds boolean
Indicates if the owner holds a DMD or DDS degree.
degree_awarded_other string
Any additional professional degrees or certifications.
Owner_specialty_info object
Detailed school information and specific clinical focus areas for specialists.
Owner_dea_file / Owner_license_file URL
Secure links to view digital copies of the DEA and State License certifications.

Financial & Insurance

eft_name / eft_bank / eft_account string
Banking and Electronic Funds Transfer (EFT) details for the office.
eft_file URL
Secure link to the voided check or banking authorization file.
list_dentist array
A simple list of IDs for all dentists associated with this office.
data_list_insurance object
Detailed Payor (PPO) summary and deep nested data for each staff dentist, including credentials and active insurance status.
data_insurance_approved array
A list of insurance plans where the office has confirmed approval/credentialing status, including secure links to approval documents.

Create Office

POST /api/create_office

Endpoint to register a new physical office location. Contact your administrator for field requirements.

Dentists

GET /api/get_dentist

Access detailed credentialing information for dental providers. This includes licensing, DEA information, educational backgrounds, and professional history.

Identity & Dates

id integer
Unique identifiers for the provider.
nanoid string
Unique identifier used for search.
full_name string
The provider's complete legal name, including middle name and professional suffix.
created_date / modified_date date string
Timestamps for record creation and the most recent credentialing update.

Personal & Contact Info

personal_info.gender / date_of_birth string / date
Basic demographic information for the provider.
personal_info.full_address string
The provider's home or primary residential address.
personal_info.dentist_email / dentist_phone string
Direct contact information for the provider.
personal_info.birthplace / us_citizen string / boolean
Citizenship and birth location details.

Professional Credentials

personal_info.dentist_npi_number string
The individual's 10-digit National Provider Identifier.
credentialing_info.license_info.dental_license object
Current state dental license details, including number, issuance, and expiration dates.
credentialing_info.license_info.dea_license object
Federal DEA registration details for prescribing controlled substances.
credentialing_info.pli object
Professional Liability Insurance (Malpractice) policy details and carrier information.

Education History

credentialing_info.education.undergraduate_school object
Undergraduate degree details, including institution name and graduation date.
credentialing_info.education.dental_school object
Professional dental school details (DDS/DMD) and clinical training history.

Disclosure Questionnaire

questionnaire object (Y/N)
A standardized 25-point professional conduct inquiry covering:
  • Licensure challenges or certification issues.
  • Criminal history or civil offenses.
  • Malpractice judgments or liability actions.
  • Health conditions affecting service delivery.
  • Regulatory agency sanctions or sexual misconduct.

Files & Attachments

specific_info.file_upload_* URL (secure)
Secure links to digital copies of verified credentials, including:
Signature, PLI, Dental License, DEA, CV/Resume, CPR Certificate, Driver's License, Diploma.

Create Dentist

POST /api/create_dentist

Endpoint to submit a new dentist application or profile.

Insurances

GET /api/get_insurances

Retrieve insurance plans and their associated credentialing states for specific dental practices.

Attributes

id integer
Internal database ID for the insurance record.
nanoid string
Public-facing unique identifier used for precise search operations.
type string
Classification of the plan. Common types include: 1: PPO, 2: AHCCCS, 3: HMO, 4: Optional PPO.
insurance_name string
Legal name of the insurance carrier.
list_state array
A list of state codes where this carrier provides coverage.

Resources & Contact Info

application_file object
A map of state-specific enrollment application files.
Sub-fields: insurance_application_file (Filename).
insurance_info_1 object
Contact channels for providers.
Sub-fields: insurance_phone, insurance_website (Portal link).
state_email object
A collection of credentialing-specific email addresses mapped by state code.

Application Credentialing

GET /api/get_applications

Track the complete lifecycle of insurance credentialing applications for your providers and offices.

Attributes

id integer
Unique identifier for the application record.
status integer
Current state of the application.
Options: 1: Approved, 2: Processing, 3: Denied, 4: Waiting, 5: New, 6: Unresponsive Insurances, 7: Cancel.
type integer
The method used for application submission.
Options: 1: Email, 2: Online.

Key Dates

approved_date / sent_date / checked_date string
Critical milestones in the credentialing timeline. Format: mm/dd/YYYY.

Documentation & Attachments

attachment URL (secure)
Direct link to the primary signed application or summary document.
entity_info object
A structured map of supporting documentation, including:
  • initial_application: Original submission files.
  • additional_docs: Supplemental evidence requested by carriers.

Relations

office_name / first_name / last_name / insurance_name string
Human-readable labels for the associated office, dentist, and insurance carrier.
BASE URL
https://credentialinggenie.com/api