iSoftpull API Documentation

Documentation - iSoftpull APIs - Intelligence Indicator & Credit Report & Score View

Getting Started

The iSoftpull API provides access to read credit report data and allows you to run intelligences. To use any of the APIs, you need to create a Key/Token pair from the API Credentials tab. The API Token is highly sensitive information. Handle it carefully and ensure that anyone else does not get access to the token.

Making a Request

To make a request to the API you need to make a POST call to the our API endpoint. 

Endpoint: https://app.isoftpull.com/api/v2/reports

The POST call must include the API Key ID and API Secret Access Token in the headers and applicant details in the body.

API Key ID/Token

Two header fields are required in the request.

  • The value of the api-key field must be set to the API Key ID
  • The value of the api-secret field must be set to the API Secret Access Token

Postman Collection

You can test the API using our Postman collection: https://www.getpostman.com/collections/ae610924d2f2d963c589

  • Download the Postman App or use the Postman Web Version
  • Click on the Import button, click on the Link tab, paste the collection link and click on Continue
  • After importing the collection, you can use any one of the three test applicants
  • Fill in the correct values for api-key and api-secret in the headers tab and click on Send

Applicant Details

The applicant details should be provided in the body of the request

FIELDDESCRIPTIONREQUIRED/OPTIONAL
first_nameFirst NameRequired
last_nameLast NameRequired
addressAddressRequired
cityCityRequired
stateState. Full Name instead of an abbreviation. i.e. 'New York' instead of 'NY'Required
zipZipcodeRequired
ssnSocial Security Number. No dashes. i.e. '212074628' instead of '212-07-4628'Optional for a soft pull. Required for a hard pull
date_of_birthDate of Birth. Uses mm/dd/yyyy formatOptional for a soft pull. Required for a hard pull

Test Applicants

FIELDRHONDATOMELON
first_nameRhondaTomElon
last_nameRouseBraydenMuskgrub
address981 Wrestlin Way2563 Buccaneer Blvd.10012 Falcon Way
cityStamfordTampa BayAustin
stateConnecticutFloridaTexas
zip069013364773301
ssn600221639212074628111111111
date_of_birth02/01/198708/03/197706/28/1978

Sample Responses

If all the applicant details are filled out, the API response will contain the reports data and/or the intelligence data depending on the configuration selected when creating the API.

The reports data will contain the status, message and report link for each bureau. The report link will only be included if the report generation was successful.

The intelligence data will contain the result (either "passed" or "no offers matched") and the intelligence name. The intelligence name will only be included if the intelligence result value was "passed".

                
{
  "reports":{
    “link”:”https://app.isoftpull.com/client/applicants/view_only/123/soft_pull”,
    "equifax":{
      "status":"failure",
      "message":"Service Unavailable.",
      "failure_type":"error"
    },
    "transunion":{
      "status":"success",
      "message":"Transunion credit report generation succeeded.",
      "link":"https://app.isoftpull.com/client/reports/view_only/9751af23-7022-700efe"
    }
  },
  "intelligence":{
    "result":"passed",
    "name":"Loan Silver"
  }
}

                
                

Error Handling

If the API doesn't receive all the mandatory applicant details, it will send an error message with a status value of "failure" and a message with the reason for failure
                
{
    "status": "failure",
    "message": "Last name can't be blank",
}
                
                

The reports data will contain the status, message and report link for each bureau. If the report fails, it will also contain the field failure_type

The failure type could be error, no-hit or freeze.

The failure_type no-hit refers to the bureau not being able to find an applicant, error refers to a generic error, and freeze refers to the applicant's report being frozen

                
{
  "reports":{
    "equifax":{
      "status":"failure",
      "message":"Service Unavailable.",
      "failure_type":"error"

    },
    "transunion":{
      "status":"failure",
      "message":"No-hit file is returned – due to state-specific criteria — more identification information is needed",
      "failure_type":"no-hit"
    },
    "experian":{
       "status":"failure",
       "message":"25& 12-28-22 0000000 FILE FROZEN DUE TO FEDERAL LEGISLATION",
       "failure_type":"freeze"
     }
  },
  "intelligence":{
    "result":"no offers matched"
  }
}

                
                





Ready to Get Started?
Need Assistance?
Submit a Ticket or Call Us at (760) 579-6171
Access Your Account




iSoftpull
(760) 579-6171
2270 Camino Vida Roble, Ste. i
Carlsbad, CA 92011

iSoftpull® 2023  © All rights reserved
    • Related Articles

    • Overview - Intelligence Indicator API

      This article reviews the primary applications for iSoftpull's Intelligence Indicator API. Overview The purpose of the Intelligence Indicator is to programmatically communicate the level of credit worthiness of a potential client, relative to their ...
    • Overview - Credit Report and Score View API

      Overview The Credit Report and Score View API enables businesses, CRMs, and other software applications to initiate credit pulls, and to view credit reports and scores inside of their current software. The benefit of this API is your employees and ...
    • Where is iSoftpull headquartered?

      iSoftpull is located just outside of San Diego in the city of Carlsbad. 2270 Camino Vida Robles, Suite I Carlsbad, CA 92011 In the area? Stop by and say hi! Ready to Get Started? View Pricing & Pick Your Plan Need Assistance? Submit a Ticket or Call ...
    • iSoftpull Score Glance

      When developing iSoftpull, it was import that we made it very easy for our customers to view their customer's credit score. This is particularly true for business that process a lot of applicants. That is whey we created the iSoftpull Score Glance, ...
    • Credit Score and Account Summary

      To quickly get an overview of your clients' credit, simply navigate to their profile by clicking on their name from the Applicants screen, the click on the relevant type of pull you would like to look at (Soft Pull or Hard Pull). You will be ...