Partner Integration Options

Integrating the Verified First platform into your cloud-based solution is faster and easier than any other vendor in the industry.  

Ordering Method 1: Embedded JavaScript Widget

Embedding a line of JavaScript code is a simple task for your development team. Embedding this code allows your users to seamlessly utilize the system with zero effort on their side, and minimal development on your side.

NOTE: Before you can test the JavaScript code, Verified First must whitelist the URL(s) it will be loaded from.

Ordering Method 2: Browser Extension (patented)

Verified First has an official browser extension with Chrome, Firefox, Edge, and Safari. This requires zero development on your side, and minimal effort for your end-users. The install process is two clicks and takes less than a minute in most cases. Simply direct them to our browser install page. 

Note: There is no browser add-on available for Internet Explorer. Because of this we recommend using the "Embed JavaScript Code" option. 

Receiving Results via the Verified First API (Recommended)

Without receiving the results via the API, results come back to the widget so that your HR team can review them within your platform. 

If you would like to receive a copy of this data to store in your platform, for reporting or gating the hiring process for example, we need:

1. Endpoint  
2. Authorization header or credentials to authenticate the message

{
 "type": "background status",
 "status_update": {
 "partner_applicant_ids": ["eb94d16f-12ce-406d-99ab-a84d00af4eea"],
 "account_number": "111-2222-33333-444444",
 "order_id": "b06a10e0-ef0b-11e8-8c06-017b64ae2d2844",
 "order_number": "2240992",
 "flagged": "No",
 "package_name": "Verified Basic",
 "products_ordered": [
 "Social Security Address Trace",
 "Nationwide Criminal Database",
 "Adjudication"
 ],
 "reference_code": "Salaries",
 "status": "Complete",
 "state": "Active",
 "adjudication": "In Need of Review",
 "url": "https://staging.verifiedfirst.com/#/report-results/b06a10e0-ef0b-11e8-8c06-017b64ae2d2844",
 "order_completed_date": "2018-12-05T18:58:31Z",
 "last_status_date": "2018-12-05T18:58:31Z"
 }
}

Field Definitions:

• partner_applicant_ids - Unique identifier of applicant from external system (received from value(s) defined in "Create Order" API call)
• account_number - Account number assigned by Verified First
• order_id - Internal Verified First order identifier
• order_number - Order number created by Verified First
• flagged - Indicates if the order is flagged (Yes/No)
• package_name - Package name used for the order
• products_ordered - The list of products contained in the selected package for the order
• reference_code - Reference code associated with the order (optional)
• status - The latest status of the order
  • Canceled - Order has been canceled by the vendor
  • Error - An error was generated when an order for a report was placed
  • Waiting on Applicant - Order has been created by the vendor
  • Invitation Sent - Invitation has been sent to applicant
  • Partially Ordered - Verified First Portal user has performed Pre-Pull tasks and has developed jurisdictions for the applicant, but has not completed the order
  • Ready to Order - Applicant has finished the invitation and the order is ready for review.  Requires Account settings (Gear > Admin > Account > Review Process) to be set to either "Allow Both" or "Manual Order Only"
  • File Ordered - Background check file has been ordered
  • Partially Complete - At least one selected product has been completed for the file
  • Complete - The file has been completed and returned
• state - The activation state of the order.  Orders that are archived (either manually or by scheduled expiration) move from "Active" state to "Inactive" state. (Active/Inactive)
• adjudication - Adjudication status of the order (this field will only have values populated if "status" is "Complete")
  • In Need of Review
  • Approved
  • Pre-Adverse Action
  • Adverse Action
• url - Link to view order
• order_completed_date - Date that the order was completed (will be filled when "status" is "Complete")
• last_status_date - Date of the most up-to-date status

Co-Branding (Recommended)

Our solution can also be co-branded with your colors and logo to provide end-users with a familiar and trusted experience. Logo requirements are listed below:

1. 600x120
2. Transparent background
3. PNG format
4. Size should be less than 100 Kb

If you have any further questions, or need a product enabled on your account, 
please contact Verified First Client Services for assistance.

Call 844-709-2708 or email ClientServices@VerifiedFirst.com