Data Quality user documentation
home/Email validation/Experian Email Validation v1/Get started/Make a test call

Make a test call

We recommend you start by making a test call to see how the API works. To make your first API request you will need:

  1. An email address you want to validate.
  2. A license to use the product. Talk to your account manager or contact us to get a license if you don't have one.
  3. Your token, which confirms you are licensed to use Email Validation and authenticates each request you send to the API. This article explains tokens and includes instructions on where to find yours.
  4. A tool that allows you to make API calls.

There are many different ways to make API requests, we provide two ways of doing that with the API by either using our sample Swagger integration or Postman collection.

To use the API from this page:

  1. Go to API specification and click the POST block, so that it expands.

  2. Click the Try it out button in the upper-right corner.

  3. Enter your token in the Auth-Token field.

  4. (Optional) Enter an identifier in the Reference-Id field.

  5. (Optional) Under emailRequest, you can replace the email value with an email address of your choice and the timeout value with a number between 3 and 15. Note that the email value must be enclosed in quotation marks, e.g. "support@experian.com". Alternatively, you can skip this step and use the preset values.

  6. (Optional) Select an option from the Parameter content type and Response content type dropdowns. Check out Supported data formats for more information.

  7. Click the Execute button to send the request to the API.

  8. View the response returned by the API under Responses > Server response. Note that your request was successful only if the API returned an HTTP status code of 200 - Success. Check out Response status codes to find out more about scenarios where the API returns errors.

This API comes supplied with a Postman collection. Postman is a free, easy-to-use third-party application you can use to send API calls.

Follow these steps to send requests to the API via Postman:

  1. Download and install the free Postman app.
  2. Download this file and unzip it.
  3. Open the Postman app and click the Import button in the upper-left corner. Postman app view
  4. Import the file you've downloaded and unzipped.
  5. Go to the Collections tab on the left-hand side panel and click the API request you want to test.
  6. Go to the Headers tab.
  7. Replace the {{Auth-Token}} value with your token.
  8. Go to the Body tab.
  9. (Optional) Replace the email value with an email address of your choice and the timeout value with a number between 3 and 15. Note that the email value must be enclosed in quotation marks, e.g. "support@experian.com". Alternatively, you can skip this step and use the preset values.
  10. Click the Send button to submit the API request.
  11. View the response returned by the API. Note that your request was successful only if the API returned an HTTP status code of 200 - Success. Check out [Response status codes]es.htm(/email-validation/experian-email-validation/api-reference/response-status-codes/) to find out more about scenarios where the API returns errors.
Experian Email Validation v1

Get started

Related Resources

Related Services