# mulesoft CAQH Connector - Full Documentation --- product: CAQH Connector version: 1.0 is-latest-version: true --- # CAQH Connector > For the full documentation index, see: https://docs.mulesoft.com/llms.txt CAQH Connector v1.0 Anypoint Connector for the Council for Affordable Quality Healthcare (CAQH Connector) provides access to a nonprofit that collects, stores, monitors, and validates healthcare providers’ information. CAQH ProView® is a web-based solution that many providers use to self-report and share wide-ranging demographic and professional information with healthcare organizations. CAQH DirectAssure®, which ensures the accuracy of provider directories, works in tandem with CAQH ProView, so providers can update their directory information in one place and share it with participating organizations. CAQH ProView and DirectAssure APIs enable users to retrieve information about providers in real time for credentialing and other purposes. Participating organizations (POs) can use the APIs to add a provider to roster in CAQH ProView. CAQH Connector simplifies access to the CAQH ProView and DirectAssure APIs to define complex integrations visually for enhanced provider management and credentialing. Release Notes: [CAQH Connector Release Notes](https://docs.mulesoft.com/release-notes/connector/caqh-connector-release-notes-mule-4) Exchange: [CAQH Connector](https://www.mulesoft.com/exchange/com.mulesoft.connectors/mule-caqh-connector/) ## Before You Begin To use this information, you should be familiar with CAQH ProView, DirectAssure, Mule concepts, Anypoint connectors, Anypoint Studio, the elements in a Mule flow, and global elements. The APIs use basic authentication, based on username and password. You need a CAQH account and credentials to use the connector. To use the CAQH connector with Maven, find dependency information on the Dependency Snippets tab of CAQH connector’s page on the Anypoint Exchange. ## POM File Information ```xml com.mulesoft.connectors mule-caqh-connector x.x.x mule-plugin ``` Replace `x.x.x` with the version that corresponds to the connector you are using. To obtain the most up-to-date `pom.xml` file information, access the connector in [Anypoint Exchange](https://www.mulesoft.com/exchange/) and click **Dependency Snippets**. ## Add the Connector to Your Studio Project Anypoint Studio provides two ways to add the connector to your Studio project: from the Exchange button in the Studio taskbar or from the Mule Palette view. ### Add the Connector Using Exchange 1. In Studio, create a Mule project. 2. Click the Exchange icon **(X)** in the upper-left of the Studio task bar. 3. In Exchange, click **Login** and supply your Anypoint Platform username and password. 4. In Exchange, search for "caqh". 5. Select the connector and click **Add to project**. 6. Follow the prompts to install the connector. ### Add the Connector in Studio 1. In Studio, create a Mule project. 2. In the Mule Palette view, click **(X) Search in Exchange**. 3. In **Add Modules to Project**, type "caqh" in the search field. 4. Click this connector’s name in **Available modules**. 5. Click **Add**. 6. Click **Finish**. ## Connector Namespace and Schema When you drag the connector from the Mule Palette view in Anypoint Studio to the canvas, Studio populates the XML code for the connector namespace, schema location, and POM file. If you create an app outside of Studio, use this information in the XML: Namespace: `http://www.mulesoft.org/schema/mule/caqh` Schema Location: `http://www.mulesoft.org/schema/mule/caqh/current/mule-caqh.xsd` ## Configure CAQH Connector in Anypoint Studio 1. In Anypoint Studio, create a new Mule project. Ensure that you have **HTTP Listener** configured. 2. Drag the connector to the Studio Canvas. 3. Configure the connector’s global element. You can either enter your credentials as global configuration properties or reference a configuration file that contains these values. For simpler maintenance and better reuse of your project, MuleSoft recommends that you use a configuration file. - **Address**: URL to access CAQH API - **Username**: The user name to access CAQH API - **Password**: Password to access CAQH API > [!TIP] An example configuration file for CAQH is available at > `src/main/resources/configuration.yml`. You can add this file in the Configuration > Properties of the Global Configuration Elements. 4. To ensure that your connection is successful, Click **Test Connection**. 5. Select a connector operation. ## Use Cases The following use cases demonstrate how you can use this connector to: - Update providers from Salesforce to CAQH using ProView - Delete Providers from Roster Using ProView To test these the use case examples: 1. Create a Mule application, and set the connector configuration properties in the configuration file in the `src/main/resources`. For example, ```yaml caqh: address: "" user: "" password: "" ``` 2. Add the configuration file for the CAQH connector to the Configuration Properties of the **Global Configuration Elements**. ### Update a Provider from Salesforce to CAQH Using ProView In this example, a Mule application queries Salesforce contacts to find a provider. It then updates the provider’s status in CAQH and gets the status of the update request. ![Update Providers Flow](/mulesoft/current/en-us/caqh-connector/latest/_images/caqh-update-provider-from-sf.png) In your Mule application, 1. Drag an HTTP Listener to the canvas and configure it. 2. From the **Palette**, search for the Salesforce connector and drag **Query** operation. 3. For the purpose of this demo, use the following query to get the contact from Salesforce. ```sql SELECT firstName, LastName, Id, CAQH_Provider_ID__c, SF_Provider_ID__c, CAQH_organization_id__c, Provider_name__c, caqh_batch_id__c from CONTACT where name = ':name' ``` 4. Select and drag Transform Message at the flow on the canvas to prepare the input for the CAQH connector. ```yaml output application/java --- [{ "caqh_provider_id": payload[0].CAQH_Provider_ID__c, "organization_id": payload[0].CAQH_organization_id__c, "po_provider_id": payload[0].Id, "last_recredential_date": "", "next_recredential_date": "05/05/2019", "delegation_flag": "Y", "application_type": "A", "affiliation_flag": "" }] ``` 5. Use the `Update Providers - ProView (PUT)` connector operation after the listener, and select the connector configuration that you created. 6. Set the **General** section in the connector configuration to `payload`. 7. Set the **Target Value** in the Advanced section to `#[payload]`. 8. Use another Transform Message component to add minimum 1 minute of wait time because it takes a few minutes to update the provider in CAQH. ```yaml %dw 2.0 import * from dw::Runtime output application/json --- payload wait 60000 ``` 9. To check whether the update request was successful, drag `Get Status - Update to Roster` operation after the **Transform Message**. 10. In the **General** section of the operation configuration, 1. Set the **Batch\_id** to `#[payload.batch_Id]`. 2. Set **Target Value** in the Advanced section to `#[payload]`. 11. Add a Transform Message component at the end of the flow to transform the output message to JSON format. Set the output of the Transform Message to, ```yaml %dw 2.0 output application/json --- payload ``` 12. Run the application and point your browser to `http://localhost:8081/update-provider`. ### Delete a Provider from Roster Using ProView In this example, a Mule application queries Salesforce contacts to find a provider. It then deletes the provider in CAQH using the ProView API and gets the status of the delete request. > [!NOTE] The delete request sets the provider status in CAQH to `Inactive`. ![Delete Providers Flow](/mulesoft/current/en-us/caqh-connector/latest/_images/caqh-delete-provider.png) The process of implementing this flow is similar to updating a provider, except you use the **Delete Providers - ProView (PUT)** and **Get Status - Delete** from Roster operations ## Use Cases: XML ### Update a Provider from Salesforce to CAQH Using ProView ```xml SELECT firstName, LastName, Id,CAQH_Provider_ID__c,SF_Provider_ID__c,CAQH_organization_id__c,Provider_name__c,caqh_batch_id__c from CONTACT where name = ':name' ``` ### Delete a Provider from Roster Using ProView ```xml SELECT firstName, LastName, Id,CAQH_Provider_ID__c,SF_Provider_ID__c,CAQH_organization_id__c,Provider_name__c,caqh_batch_id__c from CONTACT where name = ':name' ``` ## See Also - [Salesforce Help](https://help.salesforce.com) - [CAQH Solutions](https://www.caqh.org/solutions) --- product: CAQH Connector version: 1.0 is-latest-version: true --- # CAQH Connector Reference > For the full documentation index, see: https://docs.mulesoft.com/llms.txt CAQH Connector v1.0 Release Notes: [CAQH Connector Release Notes](https://docs.mulesoft.com/release-notes/connector/caqh-connector-release-notes-mule-4) The main class of an extension, is the entry point from which configurations, connection providers, operations and sources are going to be declared. ## Configurations --- ### Default Configuration Default configuration #### Parameters
NameTypeDescriptionDefault ValueRequired

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x

Connection

The connection types to provide to this configuration.

x

Address

String

x

Version

String

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before the runtime considers it eligible for expiration. This does not mean that the platform expires the instance at the exact moment that it becomes eligible. The runtime purges the instances when it sees fit.

#### Connection Types ##### Connection This class (as its name implies) provides connection instances and the functionality to disconnect and validate those connections. All connection related parameters (values required to create a connection) must be declared in the connection providers. This particular example is a PoolingConnectionProvider which declares that connections resolved by this provider will be pooled and reused. There are other implementations like CachedConnectionProvider which lazily creates and caches connections or simply ConnectionProvider if you want a new connection each time something requires one. ###### Parameters
NameTypeDescriptionDefault ValueRequired

Username

String

x

Password

String

x

Use Persistent Connections

Boolean

If false, each connection will be closed after the first request is completed.

true

Max Connections

Number

The maximum number of outbound connections that will be kept open at the same time. By default the number of connections is unlimited.

-1

Connection Idle Timeout

Number

The number of milliseconds that a connection can remain idle before it is closed. The value of this attribute is only used when persistent connections are enabled.

60000

Stream Response

Boolean

Whether or not received responses should be streamed, meaning processing will continue as soon as all headers are parsed and the body streamed as it arrives. When enabled, the response MUST be eventually read since depending on the configured buffer size it may not fit into memory and processing will stop until space is available.

false

Response Buffer Size

Number

The space in bytes for the buffer where the HTTP response will be stored.

-1

Connection Timeout

Number

60000

TLS Configuration

Protocol to use for communication. Valid values are HTTP and HTTPS. Default value is HTTP. When using HTTPS the HTTP communication is going to be secured using TLS / SSL. If HTTPS was configured as protocol then the user needs to configure at least the keystore in the tls:context child element of this listener-config.

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy

## Supported Operations - [Add Providers - DirectAssure](#addToRosterRequestDa) - [Add Providers - ProView](#addToRosterRequestPv) - [Delete Providers - ProView (POST)](#deleteFromProviewApi) - [Delete Providers - DirectAssure (POST)](#deleteFromProviewApiDa) - [Delete Providers - DirectAssure (PUT)](#deleteFromRosterRequestDaByPutRequest) - [Delete Providers - ProView (PUT)](#deleteFromRosterRequestPv) - [Get Provider Credentials](#getProviderCredentials) - [Get Provider Documents](#getProviderDocument) - [Get Provider Status - DirectAssure](#getProviderStatusDa) - [Get Provider Status - ProView](#getProviderStatusProview) - [Get Status - Add to Roster](#getResultOfAddRequest) - [Get Status - Delete from Roster](#getResultOfDeleteRequest) - [Get Status - Update to Roster](#getResultOfUpdateRequest) - [Update Providers - DirectAssure (POST)](#updateToProviewApiDa) - [Update Providers - DirectAssure (PUT)](#updateToRosterRequestDaByPutRequest) - [Update Providers - ProView (POST)](#updateToRosterRequestPv) - [Update Providers - ProView (PUT)](#updateToRosterRequestPvByPutRequest) ## Operations ### Add Providers - DirectAssure `` A partner organization (PO) can add one or more providers to the roster by submitting a call to the API. For this there are different required and optional fields for the Quick Add verses the Initial Add. Returns the batch\_id that is generated on successful addition of providers on the roster. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Add To DA Bodies

List of providers to be added to roster

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Add Providers - ProView `` A PO can add one or more providers to the roster by submitting a call to the API. For this there are different required and optional fields for the Quick Add verses the Initial Add. This method returns the batch\_id that is generated on successful addition of Providers on roster. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Add Request Bodies

List of providers to be added to Roster.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Delete Providers - ProView (POST) `` Method to delete one or more providers from the roster using POST. Returns the batch\_id that is generated on successful deletion of Providers from roster. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Delete Proview Bodies

List of providers to be deleted from Proview.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:RETRY\_EXHAUSTED - CAQH:CONNECTIVITY ### Delete Providers - DirectAssure (POST) `` Method to delete one or more providers from the roster. Returns the batch\_id that is generated on successful deletion of Providers from roster. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Delete DA By Post Bodies

List of providers to be deleted from Proview.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Delete Providers - DirectAssure (PUT) `` Method to delete one or more providers from the roster. Returns the batch\_id that is generated on successful deletion of Providers from roster. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Delete DA By Put Bodies

List of providers to be deleted from the roster

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Delete Providers - ProView (PUT) `` Method to delete one or more providers from the roster using PUT. Returns the batch\_id that is generated on successful deletion of Providers from roster. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Delete Request Bodies

List of providers to be deleted from Roster.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:RETRY\_EXHAUSTED - CAQH:CONNECTIVITY ### Get Provider Credentials `` This method returns the xml response received by Credentialing API web service which is used by Participating Organizations to access real-time provider data from CAQH ProView. Before requesting the Credentialing API access, POs should have a business case and an existing application with which to consume and use the web service. The credentialing API is designed to accept one CAQH Provider ID at a time and disseminate information for that provider based on other parameters provided in the API call. The Credentialing API service will return provider data only if it satisfies all of the following criteria: 1. Provider application status is Complete. 2. Provider has Authorized the Participating Organization to see their information. participating organization roster status of the provider is active. Data will be filtered based on Delegated/Non-Delegated and Participating/Non-Participating relationships between the participating organization and the requested provider. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Caqh Provider Id

String

CAQH assigned provider Identifier.

x

Organization Id

String

Participating Organization Identifier.

x

Attestation Date

String

Date on which provider was last first attested.Required (Only within the past 3 years).

x

Credential Section

String

(Optional) If not specified, the service will return all sections.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Get Provider Documents `` This method returns the PDF document in response to request that allows a participating organization to retrieve a provider’s supporting document The supporting documents will be returned only if the following are true: 1. The requesting user’s associated PO ID matches with the incoming PO ID, or if the incoming is the child of the user’s associated PO ID. 2. The provider is on the participating organization’s roster. 3. The provider has given authorization to the participating organization. 4. The provider’s CAQH ProView data profile is in a complete status, e.g. Initial Profile Complete or Re-attestation. If these criteria are not satisfied then the supporting document for that CAQH Provider ID is not be returned and the appropriate response code is be supplied. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Caqh Provider_id

String

CAQH assigned provider Identifier.

x

Organization_id

String

Participating Organization Identifier.

x

Doc_ Type

String

Single Supporting Document Type.

x

Output Mime Type

String

The mime type of the payload that this operation outputs.

Output Encoding

String

The encoding of the payload that this operation outputs.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Binary

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Get Provider Status - DirectAssure `` The DirectAssure Status Check API web service can be used by Participating Organizations to view the status of providers in CAQH ProView. Before requesting DirectAssure Status Check API access, partner organizations should have a business case and an existing application with which to consume and use the web service. The DirectAssure Status Check API accepts one provider at a time. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Organization_ Id

String

Participating organization identifier

x

Caqh_ Provider_ Id

String

CAQH assigned provider identifier

x

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Get Provider Status DTO

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Get Provider Status - ProView `` The ProView Status Check API web service can be used by Participating Organizations to view the status of providers in CAQH ProView. Before requesting ProView Status Check API access, POs should have a business case and an existing application with which to consume and use the web service. The ProView Status Check API accepts one provider at a time. This method returns a JSON response with the status of provider or indicate that a provider could not be found with Provider\_Found\_Flag equal to N. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Organization_ Id

String

Participating Organization Identifier.

x

Caqh_ Provider_ Id

String

CAQH assigned provider Identifier.

x

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Get Provider Status DTO

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Get Status - Add to Roster `` Method to get the status of a previous Add to Roster request, and the results if the request is complete. If a provider is unable to be added to the roster due to an Exception, then the Exception\_Description field contains a value and the identifying fields submitted in the Add to Roster Web Service is returned instead of the values from the system. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Batch_id

String

System-generated unique Batch ID from ADD request.

x

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Get Add Status DTO

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Get Status - Delete from Roster `` GET request to receive the status of a previous Delete from Roster request, and the results if the request is complete. If a provider is unable to be deleted from the roster due to an exception, then the Delete\_Description field contains the exception. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Batch_id

String

System-generated unique Batch ID from UPDATE request.

x

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Get Delete Result DTO

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Get Status - Update to Roster `` GET request to receive the status of a previous Update on Roster request, and the results if the request is complete. If a provider is unable to be updated on the roster due to an exception, then the Update\_Description field contains the exception. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Batch_id

String

System-generated unique Batch ID from UPDATE request.

x

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Get Update Result DTO

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Update Providers - DirectAssure (POST) `` Method to update one or more providers existing on roster. Returns the batch\_id that is generated on successful update of providers on the roster. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Update DA By Post Requests

List of providers to be updated in ProView

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Update Providers - DirectAssure (PUT) `` Method to update one or more providers existing on roster. Returns the batch\_id that is generated on successful update of providers on the roster. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Update DA By Put Requests

List of providers to be updated in roster

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Update Providers - ProView (POST) `` Method to update one or more providers existing on roster using POST. Returns the batch\_id that is generated on successful update of Providers on roster. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Update Proview Details

List of providers to be updated in Proview.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ### Update Providers - ProView (PUT) `` Method to update one or more providers existing on roster using PUT. Returns the batch\_id that is generated on successful update of Providers on roster. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Details

List of providers to be updated in Roster.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - CAQH:METHOD\_NOT\_ALLOWED - CAQH:INTERNAL\_SERVER\_ERROR - CAQH:NOT\_ACCEPTABLE - CAQH:REQUEST\_TIMEOUT - CAQH:GENERIC\_EXCEPTION - CAQH:BAD\_GATEWAY - CAQH:NOT\_IMPLEMENTED - CAQH:RETRY\_EXHAUSTED - CAQH:EMPTY\_HEAD\_COUNT - CAQH:CONFLICT - CAQH:SERVICE\_UNAVAILABLE - CAQH:DEAD\_TOKEN - CAQH:BAD\_REQUEST - CAQH:FORBIDDEN - CAQH:UNAUTHORIZED - CAQH:NOT\_FOUND - CAQH:CONNECTIVITY ## Types ### TLS
FieldTypeDescriptionDefault ValueRequired

Enabled Protocols

String

A comma-separated list of protocols enabled for this context.

Enabled Cipher Suites

String

A comma-separated list of cipher suites enabled for this context.

Trust Store

Key Store

Revocation Check

### Trust Store
FieldTypeDescriptionDefault ValueRequired

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the trust store.

Password

String

The password used to protect the trust store.

Type

String

The type of store used.

Algorithm

String

The algorithm used by the trust store.

Insecure

Boolean

If true, no certificate validations will be performed, rendering connections vulnerable to attacks. Use at your own risk.

### Key Store
FieldTypeDescriptionDefault ValueRequired

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the key store.

Type

String

The type of store used.

Alias

String

When the key store contains many private keys, this attribute indicates the alias of the key that should be used. If not defined, the first key in the file will be used by default.

Key Password

String

The password used to protect the private key.

Password

String

The password used to protect the key store.

Algorithm

String

The algorithm used by the key store.

### Standard Revocation Check
FieldTypeDescriptionDefault ValueRequired

Only End Entities

Boolean

Only verify the last element of the certificate chain.

Prefer CRLs

Boolean

Try CRL instead of OCSP first.

No Fallback

Boolean

Do not use the secondary checking method (the one not selected before).

Soft Fail

Boolean

Avoid verification failure when the revocation server can not be reached or is busy.

### Custom OCSP Responder
FieldTypeDescriptionDefault ValueRequired

Url

String

The URL of the OCSP responder.

Cert Alias

String

Alias of the signing certificate for the OCSP response (must be in the trust store), if present.

### CRL File
FieldTypeDescriptionDefault ValueRequired

Path

String

The path to the CRL file.

### Reconnection
FieldTypeDescriptionDefault ValueRequired

Fails Deployment

Boolean

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Reconnection Strategy

The reconnection strategy to use.

### Reconnect
FieldTypeDescriptionDefault ValueRequired

Frequency

Number

How often in milliseconds to reconnect.

Count

Number

How many reconnection attempts to make..

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

### Reconnect Forever
FieldTypeDescriptionDefault ValueRequired

Frequency

Number

How often in milliseconds to reconnect.

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

### Expiration Policy
FieldTypeDescriptionDefault ValueRequired

Max Idle Time

Number

A scalar time value for the maximum amount of time a dynamic configuration instance should be allowed to be idle before it’s considered eligible for expiration

Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the maxIdleTime attribute

### Response Status
FieldTypeDescriptionDefault ValueRequired

Headers

Object

Status Code

Number

### Request To Add Roster PVDTO
FieldTypeDescriptionDefault ValueRequired

Affiliation Flag

String

Application Type

String

Caqh Provider Id

String

Delegation Flag

String

Last Recredential Date

String

Next Recredential Date

String

Organization Id

String

Po Provider Id

String

Provider

Region Id

String

### Provider DTO
FieldTypeDescriptionDefault ValueRequired

Address1

String

Address2

String

Birthdate

String

City

String

Dea

String

Email

String

Fax

String

First Name

String

Gender

String

Last Name

String

License Number

String

License State

String

Middle Name

String

Name Suffix

String

Npi

String

Phone

String

Practice State

String

Short Ssn

String

Ssn

String

State

String

Tax Id

String

Type

String

Upin

String

Zip

String

Zip Extn

String

### Repeatable In Memory Stream
FieldTypeDescriptionDefault ValueRequired

Initial Buffer Size

Number

The amount of memory to allocate to consume the stream and provide random access to it. If the stream contains more data than can fit into this buffer, then the buffer expands according to the bufferSizeIncrement attribute, with an upper limit of maxInMemorySize.

Buffer Size Increment

Number

This is by how much the buffer size expands if it exceeds its initial size. Setting a value of zero or lower means that the buffer should not expand, meaning that a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised when the buffer gets full.

Max Buffer Size

Number

The maximum amount of memory to use. If more than that is used then a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised. A value lower than or equal to zero means no limit.

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

The unit in which all these attributes are expressed

### Repeatable File Store Stream
FieldTypeDescriptionDefault ValueRequired

Max In Memory Size

Number

Defines the maximum memory that the stream should use to keep data in memory. If more than that is consumed then it will start to buffer the content on disk.

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

The unit in which maxInMemorySize is expressed

### Request To Delete Roster DADTO
FieldTypeDescriptionDefault ValueRequired

Caqh Provider Id

String

Organization Id

String

### Get Provider Status DTO
FieldTypeDescriptionDefault ValueRequired

Authorization Flag

String

Caqh Provider Id

String

Organization Id

String

Po Provider Id

String

Provider Found Flag

String

Provider Practice State

String

Provider Status

String

Provider Status Date

String

Roster Status

String

### Get Add Status DTO
FieldTypeDescriptionDefault ValueRequired

Batch Status

String

Batch Time

String

Roster Result

### Roster Response
FieldTypeDescriptionDefault ValueRequired

Affiliation Flag

String

Anniversary Date

String

Authorization Flag

String

Caqh Provider Id

String

Delegation Flag

String

Exception Description

String

Non Responder Flag

String

Organization Id

String

Po Provider Id

String

Provider

Roster Status

String

### Provider
FieldTypeDescriptionDefault ValueRequired

Address1

String

Address2

String

Address City

String

Address State

String

Address Zip

String

Birthdate

String

Dea

String

First Name

String

Last Name

String

License Number

String

License State

String

Middle Name

String

Npi

String

Practice State

String

Status

String

Status Date

String

Type

String

Upin

String

### Get Delete Result DTO
FieldTypeDescriptionDefault ValueRequired

Batch Status

String

Batch Time

String

Deroster Result

### Deroster Result
FieldTypeDescriptionDefault ValueRequired

Caqh Provider Id

String

Delete Description

String

Organization Id

String

### Get Update Result DTO
FieldTypeDescriptionDefault ValueRequired

Batch Status

String

Batch Time

String

Roster Result

Array of Roster Result

### Roster Result
FieldTypeDescriptionDefault ValueRequired

Caqh Provider Id

String

Organization Id

String

Update Description

String

### Request To Update DADTO
FieldTypeDescriptionDefault ValueRequired

Caqh Provider Id

String

Organization Id

String

Po Provider Id

String

### Request To Update PVDTO
FieldTypeDescriptionDefault ValueRequired

Affiliation Flag

String

Application Type

String

Caqh Provider Id

String

Delegation Flag

String

Last Recredential Date

String

Next Recredential Date

String

Organization Id

String

Po Provider Id

String

## See Also [Salesforce Help](https://help.salesforce.com)