Skip to main content

Get Started

This guide is designed to help you understand Experian APIs. Here, you will find everything you need to get your first application off the ground, including sample code.

If this is your first time with Experian APIs, we recommend you to complete the steps below.

Step 1:
Create your account

Step 1 - Register

To learn more and to access Experian APIs in a sandbox environment, please register.

Register your account

Step 2:
Create your first application

Step 2 - Register your first application

Now you have successfully registered, you are ready to create an application and test our range of APIs.

  • Log in to the Developer Portal
     
  • Click on the profile tab and navigate to the My Apps section
     
  • Click on the Add new app button
     
  • Create an app name of your choice (e.g. ‘My Test App’)
     
  • Select the products you require
     
  • Select Add app to complete the registration of your App
     
  • Your applications can now be accessed in My Apps.

Step 3:
Get an access token

Step 3 - Get an access token

When you register an application, a Client ID and Client Secret are created.

These will be used to make the calls from your application to the Experian API.

Get your access token using the Client ID and Client Secret from the application you have created along with your Developer Portal username and password.

The call to get the Oauth2 token is a POST request with a Content-Type which needs to be specified as JSON; the response will also be in JSON format:

Request example

curl -X POST https://sandbox-us-api.experian.com/oauth2/v1/token \
  -H 'Accept: application/json' \
  -H 'Content-type: application/json' \
  -H 'Grant_type: password' \
  -d '{"username": "<USERNAME>","password": "<PASSWORD>","client_id": "<CLIENT_ID>","client_secret": "<CLIENT_SECRET>"}'

Response example

{
    "issued_at": "1478405901908",
    "expires_in": "7200",
    "token_type": "Bearer",
    "access_token": "eyJraWQiOiJBSmpTMXJQQjdJODBHWjgybmNsSlZPQkF3V3B3ZTVYblNKZUdSZHdpcEYxIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.
                     eyJzdWIiOiJmcmVkZGllIiwiRW1haWwiOiJmcmVkZXJpYy52YW5kZXJlbHN0QGV4cGVyaWFuLmNvbSIsIkZpcnN0TmFtZSI6ImZyZWRkaWUiL
                     CJpc3MiOiJFWFBFUklBTiIsIkxhc3ROYW1lIjoidmFuZGVyIGVscyIsImV4cCI6MTUwOTAyNDkxMSwiaWF0IjoxNTA5MDE3NzExLCJqdGkiOi
                     I1YTdlYzJhZS00YzdiLTQ3MzktYmU0MS1hMDdjZTBmNTc2N2YifQ.MINbv9JtA9JeBW0cp6mhRZ7xhOvu3oI8WDu73xInj14w1fZRX0PaHFR9
                     OsCgzGrn-7s46vS2vyScd_MWYfFRWQ8TUGpZ6Gbdh43l_B4UJxu5Uujh1bhrWA1KCsxr5p7LKNI6Pxhc76oVd2EAd0I3X7um-d_fIlds1N4KA
                     XmYtXT_oU8DklKHYiWH6L5Yx3Ue_kYQwXikqU0nXdvab35KyFCza9XqSJEeVEubTSdTvvVluzv4AJxN5X-yEtzOtNTV_Yynj4KzdYv8tpuoF2
                     LGdzp4G0fOe8mLRNY3g4rCfAnpe0yc1h6LHh0TMhu2e8jaIro4dx7b3VhLlXULm1RqPw",
    "refresh_token": "3Ib5SjC6AOUx5R47ffobFFi8DhGlC2GO"
}

Step 4:
Send your first request

Step 4 - Send your first request

Use your access token as a bearer token in the authorization header and make your first API call as shown below.

Request example

curl -X GET
 'https://sandbox-us-api.experian.com/businessinformation/businesses/v1/search' \
 -H 'accept: application/json' \
 -H 'authorization: Bearer eyJraWQiOiJBSmpTMXJQQjdJODBHWjgybmNsSlZPQkF3V3B3ZTVYblNKZUdSZHdpcEYxIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.
                           eyJzdWIiOiJmcmVkZGllIiwiRW1haWwiOiJmcmVkZXJpYy52YW5kZXJlbHN0QGV4cGVyaWFuLmNvbSIsIkZpcnN0TmFtZSI6ImZyZWRkaWU
                           iLCJpc3MiOiJFWFBFUklBTiIsIkxhc3ROYW1lIjoidmFuZGVyIGVscyIsImV4cCI6MTUwOTAyNDkxMSwiaWF0IjoxNTA5MDE3NzExLCJqdG
                           kiOiI1YTdlYzJhZS00YzdiLTQ3MzktYmU0MS1hMDdjZTBmNTc2N2YifQ.MINbv9JtA9JeBW0cp6mhRZ7xhOvu3oI8WDu73xInj14w1fZRX0
                           PaHFR9OsCgzGrn-7s46vS2vyScd_MWYfFRWQ8TUGpZ6Gbdh43l_B4UJxu5Uujh1bhrWA1KCsxr5p7LKNI6Pxhc76oVd2EAd0I3X7um-d_fI
                           lds1N4KAXmYtXT_oU8DklKHYiWH6L5Yx3Ue_kYQwXikqU0nXdvab35KyFCza9XqSJEeVEubTSdTvvVluzv4AJxN5X-yEtzOtNTV_Yynj4Kz
                           dYv8tpuoF2LGdzp4G0fOe8mLRNY3g4rCfAnpe0yc1h6LHh0TMhu2e8jaIro4dx7b3VhLlXULm1RqPw'