Importing Directory Data

Importing both Organization and Provider Data

The provider directory accuracy is a constant challenge.

  • Provider Data is Constantly Changing
  • Providers Must Update Multiple Payers
  • Manual Outreach Expense for Payers

There are two different types of data that can be imported: Organization Data and Provider Data.

Organization or Provider Data

Payors can upload their organization or provider data directly via the API to start the verification process.

Starting with obtaining the authorization token, use those values to start the Organization or Provider Data import.

TypeParamsValues
HEADAuthorization (= Bearer <token>)string
HEADclientIDInteger

Organizational Table

FieldRequiredField SizeNotes
DataTypeYesValue = "Organization"
Organization NameYes50
OrganizationTINYes9
OrganizationNPIYes10
AddressLine1Yes50Location - Street Address
CityYes50Location
StateYes50Location
ZipYes15Location
FirstNameYes50Contact
LastNameYes50Contact

Provider Table

FieldRequiredField SizeNotes
DataTypeYesValue = "Provider"
ProviderNPIYes10
FirstNameYes50
LastNameYes50
Organization NameYes50
OrganizationTINYes9
OrganizationNPIYes10
AddressLine1Yes50Location - Street Address
CityYes50Location
StateYes50Location
ZipYes15Location

Mandatory Fields Validation

The DataType must be "Organization" or "Provider". The additional mandatory fields are described in the table above.

❗️

If mandatory fields are missing from the Import Data, a system message will indicate the missing field. "[fieldname] - REQUIRED"

❗️

If the field length in incorrect, an error is populated, and the process is terminated.

👍

On successful validation of all mandatory fields, the system imports the data.

Response Codes

The table below is a partial list of responses. HTTP status codes starting with 4xx are request errors. Codes starting with 5xx are server errors.

HTTP ResultResultDescription
200Success
400Bad RequestInvalid request due to incorrect formatting or method was not supported for that type.
401UnauthorizedCredentials were incorrect.
500Server Errors