Create a target employer order

Creates a new order and verification. Returns a JSON object representing the newly created order and verification. A target employer verification is distinct in that it _requires_ a target employer in the request body for processing. ## Verification processing Target employer verifications are processed _asynchronously_: they will be created and returned in the response body without any [reports](api.yaml/paths/~1verification-requests~1{verification_id}~1report/get). Truework will then send a webhook when the request has finished processing, and the reports can be retrieved. This creates a verification request with the following attributes: - Target employer required - Is processed asynchronously - Can be any client-defined combination of Instant, Credentials, and Smart Outreach verification methods - Returns the verification on a new order object ### Controlling Processing with request config The request config object allows you to configure how you use Truework by selecting only the verification methods and features you need.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Accept"application/json"RequiredDefaults to application/json
Specify the content type and version that the API should use. It's recommended to include this to avoid breaking changes.

Request

This endpoint expects an object.
permissible_purposeenumRequired
A valid purpose is required for Truework to process the verification request. Throughout the API, this is signified by the `permissible_purpose` field. | VALUE | DESCRIPTION | | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | child-support | Determine child support payments (available to verifiers that represent a state or local child support enforcement agencies) | | credit-application | The target's application for credit | | employee-eligibility | Employee's eligibility for a benefit granted by a governmental agency required by law to consider the employee's financial responsibility or status | | employee-request | The target has issued the verifier written instruction to obtain this information | | employee-review-or-collection | Performing a review or collection of the target's account | | employment | Employment purposes where the target has given prior written consent | | insurance-underwriting-application | Underwriting insurance in response to the target's application | | legitimate-reason-initiated | Legitimate business need for the information in connection with a business transaction initiated by the target | | legitimate-reason-review | Legitimate business need to review the target's account to determine whether the employee continues to meet the terms of the account | | risk-assessment | To assess the credit or prepayment risks associated with an existing credit obligation of the target | | subpoena | For a court order or a federal grand jury subpoena
targetobjectRequired
Information on the individual who is being verified
typeenumRequired
Allowed values:
use_caseenumRequired
The verification request use case describes the type of product the verification request is originating from. If omitted, the verifier type in account settings will be used as a default | VALUE | DESCRIPTION | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------ | | mortgage | Verification for a mortgage | | home-equity | Verification for home equity | background | Verification for a background check | | tenant | Verification for a rental property | | government | Verification for government/social services | | auto | Verification for auto lending | | lending | Verification for personal loans or consumer lending | | credit | Verification for credit cards | | identity | Verification for identity or fraud | | insurance | Verification for insurance | | health | Verification for health services | | offers | Verification for offers | | account-management | Verification for account management | | preapproval | Verification for preapprovals |
additional_informationstringOptional
Any additional information about the target that can help expedite the completion of the verification request
authorization_formslist of objectsOptional
Authorization form files provided by the verifier for the verification
loan_idstringOptional
The loan id associated with the verification request
metadatamap from strings to optional stringsOptional

A single level key-value JSON object that can be used to store custom data on the verification request; keys and values must be strings

request_configobjectOptional
reseller_originating_partyobjectOptional

The originating party that requested the verification via a reseller. reseller_originating_party is required for for companies that resell data provided by Truework.

search_keystringOptional

A non-unique key that can be used to search for Orders

tenant_property_idstringOptional
The ID of the tenant property to be used for this verification request.

Response

Order Request Created.
idstring>=1 character<=128 characters
loan_idstring or null
The loan id associated with the verification request
reverificationobject or null
Response object specific to Reverification requests.
search_keystring or null

A non-unique key that can be used to search for Orders

target_employerobject or null
Response object specific to Target Employer requests.
truework_directobject or null
Response object specific to Truework Direct requests.
verification_requestslist of objects or null

Errors