Skip to main content

Self Service Portal

Looking for help with Validation Suite? Go to the user guide.

Tokens

This section provides answers to FAQs about tokens. 

What is a token?

Think of a token as your username and password. When you sign in to a website you need to use your credentials; similarly, when you want to access any of our APIs, you need to provide your token(s).

A token is a unique alphanumeric code that looks like: ab123ab1-abc1-1234-abcd-ab1a123a1a12.

We recommend you treat your tokens like your passwords: keep them secure and change them often.

What is the purpose of a token?

The purpose of a token is to authenticate the requests you send to our APIs.

Additionally:

  • It contains information about the products you are entitled to use through your license.
  • It records product usage.
  • It can be secured to prevent unauthorized parties from using your licensed products.

Where do I find my tokens?

  1. Sign in to the Self Service Portal.
  2. Go to Licenses.
  3. A list of your licenses is displayed. Note that each license has its own tokens. Identify the license whose tokens you want to find and click the associated View details button.
  4. A new page opens, where you can view the tokens associated with the license.

Now you can perform the following actions:

How do I create a new token?

We suggest you create and use multiple tokens. Check out How many tokens should I use? to find out why.

To create a new token:

  1. Follow the steps under Where do I find my tokens?
  2. Click the Add a token button.
  3. A pop-up opens, where you need to provide a name for the new token. Optionally, you can change its status (the default is Active) and manage its security.
  4. Once you’re done, click the Save button to finish creating the new token.

How do I activate a token?

Activate tokens so they can be used to send requests to our APIs.

To activate a token:

  1. Follow the steps under Where do I find my tokens?
  2. Find the disabled token and click the associated Activate button.

How do I disable a token?

Disable tokens to prevent them from being used in requests to our APIs.

To disable a token:

  1. Follow the steps under Where do I find my tokens?
  2. Find the token you want to disable and click the associated Disable button.
  3. In the pop-up that opens, click the Continue button to confirm disabling the token.

How do I edit a token?

You might want to edit a token to:

  • Rename it, so it has a friendlier, easy to distinguish name (which is useful when creating reports, for example).
  • Secure it. Don't forget, you should treat your token like a password.
  • Activate/disable it, so it can/cannot be used to send requests to our APIs. 

To edit a token:

  1. Follow the steps under Where do I find my tokens?
  2. Find the token you want to edit and click the associated Edit button.
  3. A pop-up opens, where you can edit the token: its name, status, and security settings
  4. Once you are done, click the Save button to finish editing the token.

How do I secure my tokens?

If you don't secure your tokens, there's the risk of unauthorized parties using your licensed products, which you may be charged for.

One of the easiest and most effective ways to secure your tokens is to periodically change them, just like you do with your passwords.

You can take additional steps to secure your tokens:

  • Specify CORS origin domains. By doing this, you make sure that only the API requests made from the domains you’ve specified are allowed.
  • Specify permitted URLs. By doing this, you make sure that only API requests made from the URLs you’ve specified are allowed.
  • Whitelist IPs/IP ranges. By doing this, you make sure that only API requests made from the IPs/IP ranges you’ve specified are allowed.

Follow How do I edit a token? to implement the steps listed above.

How do I find out the value of a token?

You need to find out the values of tokens so you can use them to send requests to our APIs.

To find out the value of a token:

  1. Follow the steps under Where do I find my tokens?
  2. Find the appropriate token and click the associated Get token link.
  3. A pop-up opens, where you can see the value of the token and copy it to the clipboard.

How many tokens should I use?

By default, a license comes with a token, which applies to all the products you are entitled to use through the respective license.

However, we recommend you create and use at least one token per environment (development, testing, staging, production).

Consider using multiple tokens for your production environment. This way, it’s easy to monitor and create reports on product usage and different integrations you might have.

Note: You cannot use a token across multiple licenses.

How do I check if a token is working correctly?

To check if a token is working correctly, you need to test it, by making an API call.

For testing API calls, we recommend Postman, which you can download for free. If you need help using Postman, check out the user documentation

You will know if your token is working correctly based on the status code of the response you get from the API:

Status code Is my token working correctly?
200 The request was successful and your token is working correctly.
400 The request was not successful. You might have forgotten to add the token in the request header.
401 The request was not successful. You might have used an incorrect token. Check the Self Service Portal to make sure you’ve used the right token.
403 The request was not successful. The token is valid, but it might be disabled. You can activate it in the Self Service Portal.

My token isn't working. What should I do?

There are several reasons why a token might not be working:

  • The token is disabled. Follow this guidance to activate it.
  • You have run out of credits for a product. Once you deplete the credits for a product, you are no longer able to use any of the tokens associated with the respective product. Contact your Experian Data Quality account manager to purchase more credits.
  • Your license has expired. Once your license has expired, you are no longer able to use any of the products covered by it. Contact your Experian Data Quality account manager to renew your license.

Usage Information & Reports

This section provides answers to FAQs about product usage alerts and reporting.

How do I set up a low credit alert?

For per-click products, you can set up alerts to notify you when your credit balance is low. Email notifications will be sent to you based on the limit you specify:

  1. Log in to the Self Service Portal.
  2. On the home page, select Alert settings.
  3. For each product, edit the Low credit warning column to specify the number of credits that will trigger the alert. You can set different limits for each product.
  4. Click the Save button to save your changes.

Where do I find product usage information?

You can create usage reports for all of your accounts, licenses, and products (currently excludes Clean Application & Clean API).
Usage information includes credits used, the number of searches submitted and results returned.

How do I create reports?

  1. Log in to the Self Service Portal.
  2. On the home page, click Reports.
  3. Specify the report details:
    • select the required account and license
    • choose 'All tokens' to report on all of the tokens for that license or select a specific token
    • pick the report type
    • define the date range
  1. Click the Create report button to generate the report.

What type of reports can I create?

  • Address validation - product usage information (credits used, number of searches submitted and results returned) as well as the summary of all installations and users.
  • Address verification - product usage information (credits used, number of searches submitted and results returned).
  • Data Health Check - usage information (credits used, number of searches submitted and results returned) for address, email, and phone products.
  • Email validation - product usage information (credits used, number of searches submitted and results returned).
  • Phone validation - product usage information (credits used, number of searches submitted and results returned).

Delivery Point Validation (DPV)

This section provides answers to FAQs about DPV.

What is DPV?

DPV is used by the United States Postal Service to validate whether an address is deliverable. It also provides information on the exact delivery point, for example, an apartment or suite number.

Why is my account locked?

You have encountered a seed address. A seed address is a non-existent address that will deactivate DPV functionality if it is searched upon. Seed addresses are used to prevent the illegal creation of verified address lists.

How do I unlock my account?

  1. Log in to the Self Service Portal.
  2. Click the Unlock DPV button displayed in the banner on the dashboard.
  3. Answer the two questions relating to the seed address you encountered.
  4. Click Unlock DPV.