Get One Report

1 import requests 2 3 url = "https://api.truework-sandbox.com/verification-requests/AAAAAAAAQnIAAYd5YHFVOm8PNX2ecFbEjqV__upOKUE8YE_IK2GwSQTP/reports/AAAAAAAAAKsAAYJIcQvm1nwU0xBbfC1Yh4qyqjvLhwt1B9gRmTCHCyW6" 4 5 querystring = {"fields":"id,status"} 6 7 headers = { 8 "Accept": "application/json", 9 "Authorization": "Bearer <token>" 10 } 11 12 response = requests.get(url, headers=headers, params=querystring) 13 14 print(response.json())

1 { 2 "created": "2021-12-20T18:50:20Z", 3 "current_as_of": "2021-12-20", 4 "disputes": [ 5 { 6 "created": "2021-12-20T18:50:20Z", 7 "description": "Employee Title", 8 "id": "AAAAAAAAAL8AElevkrw2n2vI8ScqGJEf50Lfg4W9LiQXwi-KSmg7DH0P", 9 "reference_id": "d75346a0-a747-4907-a506-639ea436f2b0" 10 } 11 ], 12 "employee": { 13 "first_name": "Jane", 14 "last_name": "Doe", 15 "positions": [ 16 { 17 "employment_type": "regular-full-time", 18 "title": "Software Engineer" 19 } 20 ], 21 "status": "active", 22 "status_detail": "active", 23 "address": { 24 "address": "1234 Rainbow Road", 25 "city": "San Francisco", 26 "country_code": "US", 27 "country_subdivision_code": "CA", 28 "extended_address": "Suite 300", 29 "postal_code": "98265" 30 }, 31 "earnings": [ 32 { 33 "base": "35000.00", 34 "bonus": "0.00", 35 "commission": "100.25", 36 "other": "0.00", 37 "overtime": "200.00", 38 "termination": false, 39 "total": "35300.25", 40 "year": "2020" 41 } 42 ], 43 "email": "email", 44 "hired_date": "hired_date", 45 "on_leave_date": "on_leave_date", 46 "salary": { 47 "pay_rate": { 48 "amount": "150000.00" 49 }, 50 "reduced_covid": "yes", 51 "hours_per_week": "40", 52 "pay_frequency": "annually" 53 }, 54 "social_security_number": "***-**-0000", 55 "termination_date": "termination_date" 56 }, 57 "employer": { 58 "name": "name", 59 "address": { 60 "address": "1234 Rainbow Road", 61 "city": "San Francisco", 62 "country_code": "US", 63 "country_subdivision_code": "CA", 64 "extended_address": "Suite 300", 65 "postal_code": "98265" 66 }, 67 "government_ids": [ 68 { 69 "id": "123456789", 70 "type": "us-fein" 71 } 72 ] 73 }, 74 "id": "AAAAAAAADU8ACy03lGitY_ocCMCcgproUq8Gt4r37MM6GbyX2-DxWM3Y", 75 "verification_request": { 76 "created": "2021-12-20T18:50:20Z", 77 "id": "AAAAAAAAEboABwQhKv1_pWO7MWtZs28ksPTH0uSt6GffsoIJPj7e69P1", 78 "type": "employment-income" 79 }, 80 "additional_notes": "additional_notes", 81 "d1c_eligible": true, 82 "du_reference_id": "du_reference_id", 83 "income_analytics": { 84 "annualized_income": { 85 "amount": { 86 "amount": "34.95" 87 }, 88 "short_employment_warning": true, 89 "stale_data_warning": true, 90 "variable_income_warning": true, 91 "base_amount": { 92 "amount": "34.95" 93 }, 94 "gross_amount": { 95 "amount": "34.95" 96 } 97 }, 98 "income_volatility": { 99 "gross_income_volatility": "gross_income_volatility" 100 } 101 }, 102 "paystubs": [ 103 { 104 "id": "AAAAAAAAAmEADp7bmZJNhm4Kr5FM_ty5A_JX-Rxh04GSIHwmIRyp6Xss", 105 "base": "7000.00", 106 "bonus": "1000.00", 107 "commission": "0.00", 108 "gross": "8000.00", 109 "net": "5500.00", 110 "other": "0.00", 111 "overtime": "0.00", 112 "pay_date": "pay_date", 113 "pay_period_end_date": "pay_period_end_date", 114 "pay_period_hours": "86.67", 115 "pay_period_start_date": "pay_period_start_date", 116 "reference_id": "6894632654" 117 } 118 ], 119 "pricing_tier": "instant", 120 "respondent": { 121 "email": "email", 122 "full_name": "full_name", 123 "title": "title" 124 } 125 }

Retrieves a Report for a given Verification id with multiple reports. If you don’t have the report id, it is recommended to use the embedded reports key from GET /verification-requests/{verification_id} to retrieve reports.

You can get the report in PDF format by adding Accept: application/pdf to your headers. When testing, please use the generated curl command with --output <PDF filename> specified.

<!— theme: info —>

Only completed Verifications have Reports associated with them. Any other request will fail with either 400 or 404, and provide more information as an attached error message. Reports are also embedded into the Verification object returned from get and get one.

Retrieves a Report for a given Verification id with multiple reports. If you don't have the report id, it is recommended to use the embedded `reports` key from `GET /verification-requests/{verification_id}` to retrieve reports. You can get the report in PDF format by adding `Accept: application/pdf` to your headers. When testing, please use the generated curl command with `--output <PDF filename>` specified.  > Only completed Verifications have Reports associated with them. Any other request will fail with either 400 or 404, and provide more information as an attached error message. > Reports are also embedded into the Verification object returned from get and get one.

Authentication

AuthorizationBearer

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

Path parameters

verification_request_idstringRequired

Verification ID

verification_report_idstringRequired

Report ID

Query parameters

income_analyticsbooleanOptionalDefaults to false

Whether to calculate income analytics for the nested reports in each verification.

fieldsstringOptional

Comma-separated names of fields to include in the response. If omitted, all fields are included

Response

createddatetime

current_as_ofstringformat: "date"

disputeslist of objects

Disputes that are currently open and relevant to this report

employeeobject

employerobject

idstring>=1 character<=128 characters

verification_requestobject

additional_notesstring or null>=0 characters

d1c_eligibleboolean or null

Returns true if this report is eligible for Day 1 Certainty

du_reference_idstring or null

This is the reference ID to submit to Fannie Mae for purposes of getting Day 1 Certainty

income_analyticsobject or null

Calculated income features. Only returned if the income_analytics query parameter is provided and is true and the employee status on the report is active.

paystubslist of objects or null

Individual paystubs for each pay period. Paystubs are returned sorted in descending order from most recent to least recent pay date.

pricing_tierenum or null

Allowed values:

respondentobject or null

Authentication

Path parameters

Headers

Query parameters

Response

Errors