Verified First provides an API that allows access to client data for full or partial integrations with various partner systems. We also provide standard request and response formats that can be used to:

• Place orders and retrieve order information
• Retrieve account information and product information
• Create, modify, or delete packages and users

Verified First provides endpoints for both production and staging/test environments:

Production Environment:

Verified First Production Portal: https://portal.verifiedfirst.com/

Associated API: https://api1.verifiedfirst.com/external/verified-first/

Staging/Test Environment:

Verified First Staging/Test Portal: https://staging.verifiedfirst.com

Associated API: https://api2.verifiedfirst.com/external/verified-first/

All new integrations and API connections must first be implemented and reviewed in the Staging/Test Environment.  In order to successfully implement and review in Staging/Test environment, you must meet the following requirements:

• There must be a user account in both the Verified First Production and Staging Portals.
• You must coordinate with the Verified First Integrations team to configure, setup, and activate the formats. You can contact our Integrations Team at integrations@verifiedfirst.com to request a partial or full API integration with the Verified First platform.
• Verified First will need to whitelist external domains and/or IP addresses. Please contact our Integrations Team at integrations@verifiedfirst.com to request additions to our whitelist.

Here are some examples of common API operations and the standard formats utilized by our partners.

Create Order - Used to place an order

Note: the field "mvrlicensenumber", "mvrduration", and "mvrstate" can only be added for an instant order and will be proceeded if the selected package contains an MVR product. In addition, the field "urine_test_purpose" can only be added for "app_invitation" orders and will be proceeded if the selected package contains a Drug Screening product.  

The following values are available for the field “urine_test_purpose”:

"Pre-Employment", "Random", "Periodic", "Post Incident", "For Cause", "Reasonable Suspicion", "Return To Duty", "Follow Up", "Reconfirmation", "Retest", "Point Of Collection Sampling", "Student", and "Other".

Get Package List - Retrieve list of defined packages in Verified First

POST Back Request

The Verified First API provides a method to send order results to an external platform if the following items are provided from the external system:

• API Endpoint
• Authorization header or credentials to authenticate the message

The data sent from Verified First does not contain any Personally Identifiable Information (PII) and can be stored in external platforms without the worry of inadvertently releasing access to sensitive information.

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
• Applicant Declined - the applicant clicked on the "Refuse the Background Check" link in the applicant invite email
• Applicant Invitation Expired - the applicant failed to complete the applicant invite within the allotted time
• Applicant is Minor - the applicant is younger than 15 years old and the application has been canceled
• Canceled - the order has been canceled by the vendor
• Complete - the file has been completed and results returned
• Draft Orders - the Verified First portal user has begun the order processing, but did not complete and submit the order
• Error - an error was generated when an order for a report was placed
• File Ordered - the background check has been ordered
• Invitation Sent - an invitation has been sent to applicant to complete their portion of the background screen
• Partially Complete - at least one product in the order has been marked as completed for the file
• Ready to Order - the 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"
• User Withdrew the Invite - the applicant invite has been withdrawn
• Waiting on Applicant - the order has been created and information is needed from the applicant in order to submit the order
• 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")
• Ready for 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 recent status update

Generate Pre-Signed URL for Upload Attachments

Upload Attachments

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