# Test a destination

Testing a <u>**destination**</u>, or endpoint, in your Redox organization allows you to make sure you can receive data as expected from Redox. Typically, you test destinations during <u>onboarding to Redox</u> or <u>implementing a new connection</u> before go-live.

There are two Redox dashboard tools for testing your destinations: 

- <u>**Notifications Explorer**</u>: Send test Redox data model or FHIR messages to your configured destination(s). This tests your endpoint connectivity to simulate the Redox \> destination part of your flow.
- <u>**Dataset Tester**</u>: Send test datasets to your configured destination(s). This tests your entire integration by simulating the source \> Redox \> destination flow. This is especially useful for <u>cloud connectivity</u> users. [Learn more about cloud connectivity](/basics/connecting-to-the-cloud-with-redox).

## Prerequisites

- You must have at least one destination already configured in order to test it. [Learn how to set up destinations](/how-to-use-redox/manage-your-redox-setup/set-up-destinations).
- _Constraint_: The rate limit when using any of our DevTools is lower than our standard rate limit. You can send up to 5 API requests per every 5 minutes with any of our test tools. [Learn more about our quotas and constraints](/api-reference/quotas-and-constraints). 

## Test endpoint connectivity with Notifications Explorer

Use <u>Notifications Explorer</u> to check your endpoint connectivity and its ability to accept Redox formats (i.e., [Redox data models](https://docs.redoxengine.com/permalink/data-model-landing-page) or [Redox FHIR](https://docs.redoxengine.com/permalink/1lItq4hvr0ZfD3ZLvTsL6P)). This means simulating an individual message coming from Redox to one of your destinations (Redox \> destination). 

1. Log in to the Redox dashboard. 
2. From the navigation menu, click the **Developer** page.
3. By default, the <u>Sources</u> tab opens. Click the **Test Tools** tab.
4. The <u>Notifications Explorer</u> opens. From the <u>API</u> drop-down, select either **Data Model API** to test receiving data model messages or **FHIR API** to test receiving FHIR notifications or messages. 


> **Reference links**
>
> For data model specs, [review our data model reference](https://docs.redoxengine.com/permalink/data-model-landing-page).
>
> For FHIR message or notification specs, [review our FHIR notification reference](https://docs.redoxengine.com/permalink/1lItq4hvr0ZfD3ZLvTsL6P). 


5. From the <u>Destination</u> drop-down, select the existing **destination** you want to test. 
To create a new one, [learn how to set up destinations](/how-to-use-redox/manage-your-redox-setup/set-up-destinations). 


![A user populates the API and Destination drop-downs in Notifications Explorer](https://images.ctfassets.net/cl3wt5ehhnlv/39xCdwyiRUuMs3kHbhoT3L/c6cf0f9fabc513f922dc5f0b948f2d07/notifications-explorer-select-api-and-destination.gif)

*Select API and destination*


6. The <u>Send with credentials</u> toggle allows you to override the destination’s configured auth credential or verification token for testing purposes. [Learn about authenticating incoming data](/basics/data-exchange-with-redox/receiving-data-from-redox). 
Toggle to **ON** and select a different **auth credential** from the drop-down menu.
Toggle to **OFF** to use the configured auth credential or verification token to authenticate the test message.

![A user selects an alternative auth credential to verify the selected destination.](https://images.ctfassets.net/cl3wt5ehhnlv/6HhUJGoPd6w0iMJAUXoUmT/a9e4178ba950db55cba7d17bf09c0d9a/notifications-explorer-send-with-credentials.gif)

*Send with credentials*


7. Depending on which API you selected, a drop-down for the set of data models or FHIR messages and notifications displays. Select the type of **test message** to send. 
8. Another drop-down may appear with examples. If there’s more than one example available, select the **example** you want to use. 
9. The example payload appears. Make any modifications you want to the payload. Once you’re finished reviewing or making changes, click the **Send** button.
10. A success or failed notification appears. The notification contains a link to the related log ID so you can view the details. 


![A user sends a data model and reviews the log. ](https://images.ctfassets.net/cl3wt5ehhnlv/3bErmZIVq03fjxfQiiW3BT/006371277ada68fa961c7cc4ff90a656/notifications-explorer-send-message.gif)

*Send a test message*

 

> **Log inspector not available**
>
> Log inspector isn’t available for test messages sent through Notifications Explorer since this only simulates the <u>Redox \> destination</u> portion of the flow. If your test message fails, check your destination’s configuration to make sure it was entered correctly.



## Test full data flow with Dataset Tester

Use <u>Dataset Tester</u> to validate that your destination can receive data in the raw format (e.g., HL7v2, C-CDA, X12) that your connection sends. This means simulating data coming from a source being processed by Redox then delivered to one of your destinations (source \> Redox \> destination). 

This allows you to see the full breadth of how your subscription will work, since you’ll see how data will change from source to destination. This may help you make any necessary configuration changes before go-live.

> **Test source**
>
> Running <u>**Dataset Tester**</u> automatically generates a test source in the given environment. A new test source is created for each dataset type and destination combo you select. This occurs in both <u>**development**</u> and <u>**staging**</u> environments. 
>
> Keep in mind the following when new sources are created: 
>
> - Once you have multiple sources, you must include the source ID in outgoing API requests. [Learn about including source details](/basics/data-exchange-with-redox/Managing-source-details-in-outgoing-requests). 
> - You may see details of these test sources when you retrieve all sources for a given environment using the Redox Platform API. [Review the Get sources spec](https://docs.redoxengine.com/permalink/e7d2a75e-db15-5c0b-9690-dd785b4cfd1e-get-sources).

1. Log in to the Redox dashboard. 
2. From the navigation menu, click the **Developer** page.
3. By default, the <u>Sources</u> tab opens. Click the **Test Tools** tab.
4. The <u>Notifications Explorer</u> opens. Click the **Dataset Tester** toggle option.


> **Staging or dev environments only**
>
> You can’t use <u>Dataset Tester</u> in a production environment. This warning to switch to a <u>**non-production**</u> environment appears if you’ve selected Dataset Tester while in a production environment.
>
> ![An example of a warning message in the Redox dashboard if you try to use Dataset Tester in a production environment. ](https://images.ctfassets.net/cl3wt5ehhnlv/3MQcTP7CVoUmMwrfzyBFbK/04901b8df47d3ec55844ecd6c05f1dba/dataset-tester-prod-warning.png)


5. From the <u>Dataset</u> drop-down, select the relevant **dataset type**. We currently support sending one of these dataset types to one of your configured destinations:
   - HL7v2 ADT
   - C-CDA
   - X12 835
   - X12 837
6. From the <u>Destination</u> drop-down, select the existing **destination** you want to test.
7. Click the **Send** button. 


![A user selects a test HL7v2 ADT message to send to a configured destination.](https://images.ctfassets.net/cl3wt5ehhnlv/7M85scIapGS5XLhYFIB68N/c87a1ede3668b1a24bc0a8efe59aeba8/dataset-tester-send-message.gif)

*Send with Dataset Tester*




> **Rate limit error**
>
> You receive an error message if you exceed the rate limit (i.e., sending more than 5 test datasets in 5 minutes). If you get an error, wait a few minutes and try again.


8. A success or failed notification appears. To view the logs, click the **View logs** link. 
9. The <u>Logs</u> page opens with the appropriate filters applied so you can see all the logs that resulted from the full dataset. Review the outcome of the message in the log. 

![A user clicks the View logs link and the relevant logs open. ](https://images.ctfassets.net/cl3wt5ehhnlv/581gL8Vrj8b07p57Qy602K/4e5bc1ff5e084163795e5f0ffbdb9392/dataset-tester-view-logs.gif)

*View logs*



> **Error notifications**
>
> If a test dataset fails, the resulting error is either from Redox or your own system, since you own the destination. This gives you the opportunity to see what might fail and how your system handles those errors.
>
> To dig into any errors or unexpected mappings, [run log inspector](/how-to-use-redox/run-log-inspector) and review the error details in the <u>Deliveries</u> tab (under the <u>Destination</u> section). Then, make any necessary adjustments to your configuration(s).



> **Test sources**
>
> In addition to testing destinations, you can also [test your sources](/quickstart-for-redox/send-test-messages-via-redox) to make sure your system can send the data your connection is expecting.

> **Platform API endpoints**
>
> This article describes how to test destinations in the <u>**Redox dashboard**</u>. To run Dataset Tester via <u>API</u>, use this <u>**Redox Platform API**</u> endpoint instead:
>
> - [Run dataset tester](https://docs.redoxengine.com/permalink/1ef24983-81b5-5643-921e-9e4cecef3284-run-dataset-tester)
