# Property Management
{% hint style="info" %}
#### Demo Environment
When sending test data to the following endpoints, change the domain to `https://demo-api.certn.co`.
{% endhint %}
To view a list of all application parameters, visit [application-parameters](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters "mention").
## Applications
An application is a single request containing a variety of checks for one applicant. These endpoints allow you to create, upgrade, and retrieve the applications associated with your team.
## Invite an applicant
`POST` `https://api.certn.co/api/v2/applications/invite/`
Invite an applicant to complete a screen.
Provide information in the body of the request to pre-fill the application forms.
To invite multiple applicants at once use the `grouped_applicants` parameter. Add each applicant as an object within the array, and provide an `email` (required) and a [`phone_number`](https://docs.certn.co/api/certn-api-v-1.0/resources/application-parameters#phonenumber) (optional).
#### Request Body
| Name | Type | Description |
| ------------------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------- |
| email\* | string | Applicant's email address |
| tag | string | Group related applications by tag |
| phone\_number | object | [#phonenumber](https://docs.certn.co/api/certn-api-v-1.0/resources/application-parameters#phonenumber "mention") |
| information | object | [#information](https://docs.certn.co/api/certn-api-v-1.0/resources/application-parameters#information "mention") |
| {request\_flag}\* | boolean | [request-flags](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters/request-flags "mention") |
{% tabs %}
{% tab title="201: Created PM application successfully created" %}
{% tabs %}
{% tab title="Response type" %}
{% code title="application/json" %}
```json
{
"id": string ,
"created": string ,
"modified": string ,
"applicants": [
{
"id": string ,
"status": string ,
"first_name": string,
"last_name": string,
"email": string,
"phone_number": {
"phone_type": string ,
"number": string",
"country": string
}
}
]
}
```
{% endcode %}
{% endtab %}
{% tab title="Example" %}
{% code title="application/json" %}
```json
{
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"applicants": [
{
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "Pending",
"first_name": "string",
"last_name": "string",
"email": "string",
"phone_number": {
"phone_type": "NONE",
"number": "+1 250 555 1234",
"country": "CA"
}
}
]
}
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="400: Bad Request Missing field, wrong data type, account not configured" %}
This may be happening because:
**You are missing required fields**
Add all the required fields to the body of your request.
**You used the wrong format or data type for a field**
Format all your fields according to their [data type](https://www.w3schools.com/js/js_json_datatypes.asp).
**Your account isn't configured to run this check**
[Contact our support team](https://docs.certn.co/api/certn-api-v-1.0/contact#api) to have your account configured for this check.
*See* [#400-bad-request](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#400-bad-request "mention") *for more details.*
{% endtab %}
{% tab title="500: Internal Server Error Wrong data type" %}
This may be happening because:
**You used the wrong format or data type for a field**
Format all your fields according to their [data type](https://www.w3schools.com/js/js_json_datatypes.asp). Most fields in our API take strings, while request flags take booleans.
*See* [#500-internal-server-error](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#500-internal-server-error "mention") *for more details.*
{% endtab %}
{% endtabs %}
## Screen an applicant instantly
`POST` `https://api.certn.co/api/v2/applications/quick`
Screen an applicant using only the information in the body of your request.
[Get the applicant's consent](https://docs.certn.co/api/certn-api-v-1.0/guides/use-the-api/consent) *before* running the screen.
#### Request Body
| Name | Type | Description |
| ------------------------------------------------------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| tag | string | Group related applications by tag |
| email | string | Applicant's email address |
| information\* | object | [#information](https://docs.certn.co/api/certn-api-v-1.0/resources/application-parameters#information "mention") |
| {request\_flag}\* | boolean | [request-flags](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters/request-flags "mention") |
| position\_or\_property\_location\* | object | [#position-or-property-location](https://docs.certn.co/api/certn-api-v-1.0/resources/application-parameters#position-or-property-location "mention") |
{% tabs %}
{% tab title="201: Created PM application successfully created" %}
{% tabs %}
{% tab title="Response type" %}
{% code title="application/json" %}
```json
{
"id": string ,
"created": string ,
"modified": string ,
"tag": string,
"(request_flags)": boolean
"last_updated": string ,
"submitted_time": string ,
"is_submitted": boolean,
"applicant_type": string ,
"report_status": string ,
"status": string ,
"status_label": string ,
"result": string ,
"result_label": string ,
"certn_score": number,
"certn_score_label": string ,
"applicant_account": {
"id": string,
"email": string
},
"application": {
object (Application)
},
"country": "CA",
"information": {
object (Information)
},
"employment_verification": string ,
"education_verification": string ,
"credential_verification": string ,
"reference_result": {
object (BasePackageResult)
},
"information_result": {
object (BasePackageResult)
},
"risk_result": {
object (RiskResult)
},
"equifax_result": {
object (EquifaxResult)
},
"identity_verified": boolean,
"employment_verified": boolean,
"identity_verification": {
object (Identity Verification)
},
"enhanced_identity_verification": {
object (EnhancedIdentityVerification)
},
"manual_id_verification": {
object (ManualIDVerification)
},
"rcmp_result": {
object (BasePackageResult)
},
"us_criminal_record_check_result": {
object (USCriminalRecordCheckResult)
},
"verification_result": {
object (VerificationResult)
},
"international_criminal_record_check_result": {
object (BasePackageResult)
},
"motor_vehicle_record_result": {
object (BasePackageResult)
},
"salary": number,
"sufficient_salary": boolean,
"high_risk_vulnerable_sector": boolean,
"job_safety_undue_risk": boolean,
"early_termination": number,
"early_termination_label": string ,
"reliability_risk": number,
"reliability_risk_label": string ,
"workplace_misconduct": number,
"workplace_misconduct_label": string
}
```
{% endcode %}
{% endtab %}
{% tab title="Example" %}
{% code title="application/json" %}
```json
{
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"tag": "Sub-Client 123",
"request_base": false,
"request_behavioural": false,
"request_softcheck": true,
"request_us_ssn_verification": false,
"request_equifax": true,
"request_identity_verification": false,
"request_enhanced_identity_verification": false,
"request_criminal_record_check": false,
"request_enhanced_criminal_record_check": false,
"request_us_criminal_record_check_tier_1": false,
"request_us_criminal_record_check_tier_2": false,
"request_us_criminal_record_check_tier_3": false,
"request_international_criminal_record_check": false,
"request_motor_vehicle_records": false,
"request_employment_verification": false,
"request_education_verification": false,
"request_credential_verification": false,
"request_employer_references": false,
"request_address_references": false,
"request_employer_phone_references": false,
"request_address_phone_references": false,
"request_instant_verify_employment": false,
"request_instant_verify_education": false,
"request_instant_verify_credential": false,
"last_updated": "2021-11-12T21:21:50Z",
"submitted_time": "2021-11-12T21:21:50Z",
"is_submitted": true,
"applicant_type": "STANDARD",
"report_status": "IN_PROGRESS",
"status": "Pending",
"status_label": "Pending",
"result": "REVIEW",
"result_label": "Review",
"certn_score": 85,
"certn_score_label": "PASS",
"applicant_account": {
"id": "string",
"email": "string"
},
"application": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"email": "string"
},
"country": "CA",
"information": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"first_name": "Sebastien",
"middle_name": "Jack Pierre",
"last_name": "Normandin",
"last_name_at_birth": "string",
"former_names": "string",
"alias": "string",
"date_of_birth": "2021-11-12",
"phone_number": "250-123-1234",
"sin_ssn": 123123123,
"gender": "M",
"birth_city": "string",
"birth_province_state": "string",
"birth_other_province_state": "string",
"birth_country": "string",
"license_number": "string",
"license_valid": true,
"license_prov_state": "string",
"license_other_country": true,
"license_type": "CA",
"cover_letter": "string",
"addresses": [{
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2",
"rent_or_own": "R",
"cost": 0,
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string",
"address_reference": {
"email": {
"address": "email@certn.co"
},
"phone_number": {
"phone_type": "NONE",
"number": "+1 250 555 1234",
"country": "string"
},
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
},
"contact": {
"can_contact": true,
"can_contact_after_date": "2021-11-12"
}
}
}
],
"employers": [{
"company_name": "string",
"position": "string",
"income": 8500,
"pay_period": "PER_HOUR",
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string",
"employer_reference": {
"email": {
"address": "email@certn.co"
},
"phone_number": {
"phone_type": "NONE",
"number": "+1 250 555 1234",
"country": "string"
},
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
},
"contact": {
"can_contact": true,
"can_contact_after_date": "2021-11-12"
}
}
}
],
"educations": [{
"institution": "string",
"degree": {
"degree": "2021-11-12",
"verified": true
},
"address": {
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2"
},
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string"
}
],
"convictions": [{
"offense": 2002,
"date_of_sentence": "2000-01-01T00:00:00.000Z",
"court_location": "Toronto, ON, Canada",
"description": "Robbery; Theft over $200"
}
]
},
"employment_verification": "VERIFIED",
"education_verification": "VERIFIED",
"credential_verification": "VERIFIED",
"reference_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"information_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"risk_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"risk_evaluations": [{
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"overall_score": "PASS",
"risk_information_result": {},
"criminal_results": [{
"confidence": 0,
"confidence_label": "Likely",
"overall_score": "PASS",
"criminal_identity": {
"criminal_cases": [{
"case_type": "Criminal",
"number": "123asd",
"file_date": "2000-12-12",
"judgment_date": "2000-12-12",
"summary_description": "The case filings summary description",
"full_description": "string",
"notes": "No additional case notes available",
"court": {
"court": "Seattle Superior Court",
"court_type": "Criminal",
"docket_number": "545fjd",
"filed_date": "2000-12-12",
"served_date": "2000-12-12",
"trial_date": "2000-12-12",
"jurisdiction": "Seattle County"
},
"criminal_charges": [{
"offense_description": "Breach of peace",
"offense_date": "2000-12-12",
"offense_type": "Felony",
"plea": "Not Guilty",
"hearing_date": "2000-12-12",
"hearing_type": "Open court hearing",
"probation": "No probation given",
"community_service": "No community service given",
"sentence_suspended": "None",
"fines": "No fines given",
"fines_paid_status": "Fines not paid",
"fines_paid_date": "2000-12-12",
"cost": "200",
"restitution": "None",
"transferred_jurisdiction": "Transferred from Seattle",
"transferred_case_number": "690330",
"active_warrant": "No active warrant",
"jail_time": "6 months jail time",
"prison_time": "6 months prison time",
"charge_in_progress": "no charge in progress",
"charge": "Vehicular manslaughter two counts",
"charge_level": "Felony",
"charge_class": "None",
"dispositions": [{
"offense_description": "Speeding",
"offense_type": "Infraction",
"offense_date": "2000-12-12",
"description": "Description of the disposition offense",
"disposition_date": "2000-12-12",
"statue": "20-1212(B)",
"offense_class": "The offense class description",
"final_plea": "Not Guilty",
"disposition_description": "The description of the dispostion"
}
],
"arrests": [{
"arrest_date": "2000-12-12",
"booking_number": "42069",
"citation_number": "247365",
"arresting_agency": "KERSHAW COUNTY DETENTION CENTER",
"offense_type": "Misdemeanor",
"offense_description": "A description of the arresting offense",
"counts": "Arrest has 6 counts"
}
],
"sentences": [{
"sentence_type": "Community Service and Fines",
"duration": "6 months",
"amount": "100",
"amount_paid": "50",
"paid": "Half the fine has been paid",
"qualifier": "The sentence has no qualifier information",
"description": "The sentence description",
"effective_date": "2000-12-12",
"appearance_date": "2000-12-12",
"appearance_finding": "There are no appearance findings to detail about the sentence"
}
],
"additional_informations": [{
"description": "More case information was found.",
"additional_description": "None",
"event_date": "2000-12-12"
}
]
}
]
}
],
"criminal_alerts": [{
"parent_category": "FRAUD",
"category": "Burglary",
"stage": "Conviction",
"type": "Citation",
"description": "Convicted of burglary",
"date": "2000-12-12",
"parent_category_label": "Fraud"
}
],
"criminal_sources": [{
"name": "World News",
"url": "worldnews.com",
"date": "2000-12-12",
"format": "Online Media",
"headline": "Burglary Conviction for Area Man",
"publication_source": "World News Conglomerate",
"publisher": "World News"
}
],
"criminal_addresses": [{
"start_date": "2000-12-12",
"end_date": "2000-12-12",
"unit": "1a",
"address": "123 fort st.",
"city": "Victoria",
"province_state": "BC",
"country": "Canda",
"postal_code": "V8X2C3"
}
],
"criminal_additional_informations": [{
"aliases": [
"willy will",
"billy bill"
],
"dates_of_birth": [
"2000-12-12"
],
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
}
}
]
}
}
]
}
]
},
"equifax_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"description": "The financial score is based on self-provided information from the applicant and an analysis of the applicant's information available to Certn. This includes a credit check, Equifax record analysis, as well as other important informational data points",
"total_debt": 100,
"upgradable": false,
"trades": [{
"credit_grantor": "RBC",
"payment_status": "Up to date",
"date_opened": "2000-12-12",
"account_rating": "High",
"date_reported": "2000-12-12",
"account_type": "Revolving",
"high_credit": 2000,
"balance_amount": 1000,
"last_activity_or_payment": "Paid as up to date",
"r_code": "R-1",
"percent_credit_used": 50,
"account_number": "112ksjd",
"past_due_amount": 0,
"payment_term_amount": 120,
"months_reviewed": 15,
"narratives": [
"Account has been paid in full."
]
}
],
"employers": [{
"employment": "Subject's Current Employer",
"occupation": "Software",
"employer": "Certn",
"city": "Victoria",
"province": "BC",
"verification": true,
"salary": 1000000
}
],
"addresses": [{
"address": "123 fort st.",
"civic_number": 123,
"street_name": "fort st.",
"city": "Victoria",
"province": "BC"
}
],
"collections": [{
"date_of_last_payment": "2000-12-12",
"creditor": "Boys Club",
"amount_owed": 10000,
"amount_paid": 50,
"ledger_number": "123aslld",
"date_paid": "2000-12-12T00:00:00.000Z",
"date_reported": "2000-12-12T00:00:00.000Z",
"assigned_date": "2012-12-12T00:00:00.000Z",
"verification_date": "2000-12-12T00:00:00.000Z",
"account_designation": "Individual",
"first_deliquency": "2000-12-12T00:00:00.000Z",
"agency_entity": "GQC123",
"reason": "Credit not paid on in full",
"description": "Parking ticket"
}
],
"deposit_alerts": [{
"customer_entity": "RBC",
"date_reported": "2000-12-12T00:00:00.000Z",
"account_type": "Business",
"date_opened": "2000-12-12T00:00:00.000Z",
"date_closed": "2000-12-12T00:00:00.000Z",
"date_written_off": "2000-12-12T00:00:00.000Z",
"amount_written_off": 2000,
"alert_status": "High",
"alert_status_date": "2000-12-12T00:00:00.000Z"
}
],
"bankruptcies": [{
"account_type": "Individual",
"liability_amount": 2000,
"asset_amount": 20000,
"customer": "CRED COUNSELLING SOC",
"case_number_and_trustee": "12312 CE ASSOCIATES",
"filer": "Subject",
"legal_narrative": "No legal information available",
"date_filed": "2000-12-12T00:00:00.000Z",
"intent_or_disposition": "Discharged"
}
],
"judgments": [{
"plaintiff": "Fred Rickleson",
"defendant": "Rick Frederickson",
"amount": 1000.21,
"date_filed": "2000-12-12T00:00:00.000Z",
"date_satisfied": "2000-12-12T00:00:00.000Z",
"verification_date": "2000-12-12T00:00:00.000Z",
"court_entity": "RBC",
"garnishee": "RBC",
"description": "Fred sued Rick"
}
],
"legal_items": [{
"case_number": "1232djdsj",
"verification_date": "2000-12-12T00:00:00.000Z",
"update_source_code": "Tape rptd",
"date_filed": "2000-12-12T00:00:00.000Z",
"court_entity": "Toronto small claims",
"status_code": "Satisfied",
"date_satisfied": "2000-12-12T00:00:00.000Z",
"amount": 10000,
"defendant": "John Smithy",
"plaintiff": "Smith Johny",
"lawyer_name_address": "Johnson LLC 123 fort st Victoria",
"legal_item_description": "It was very bad deal"
}
],
"liens": [{
"amount": 1000,
"date_filed": "1999-12-12T00:00:00.000Z",
"lien_class": "Class A",
"date_released": "1990-12-12T00:00:00.000Z",
"date_verified": "1990-12-12T00:00:00.000Z",
"court_entity": "Superior Court.",
"case_number": "123asda",
"lien_description": "Lien on house."
}
],
"secured_loans": [{
"date_filed": "1990-12-12T00:00:00.000Z",
"court_entity": "Superior",
"creditor_name_address": "RBC 123 Main st.",
"creditor_industry_code": "620a",
"maturity_date": "1990-12-12T00:00:00.000Z"
}
],
"fraud_warnings": [{
"product_description": "Fraud warnings are warnings of fraud.",
"message_priority": "Very high",
"message_code": "123a",
"message_description": "High fraud alert for bank fraud"
}
],
"non_sufficient_funds": [{
"date_reported": "1990-12-12T00:00:00.000Z",
"creditor_entity": "RBC",
"nsfamount": 1000.2,
"details": "No sufficient funds in savings account.",
"verification_date": "1990-12-12T00:00:00.000Z"
}
],
"credit_file_metadatas": [{
"hit_strength_indicator": "HIT",
"request_number": "123asd",
"address_discrepancy": "No discrepancy found in address",
"customer_number": "123asd",
"report_id": "123asd",
"file_since_date": "1990-12-12T00:00:00.000Z",
"date_of_last_activity": "1990-12-12T00:00:00.000Z",
"date_of_request": "1990-12-12T00:00:00.000Z",
"hit": "Big Hit",
"data_warning_messages": [
"No data warning messages"
],
"card_alert_warning_messages": [
"Credit card on high alert"
],
"alert_indicators": [
"No messages"
]
}
],
"other_incomes": [{
"date_reported": "1990-12-12T00:00:00.000Z",
"income_source": "RBC",
"amount": 1000000,
"verification_date": "1990-12-12T00:00:00.000Z"
}
],
"consumer_statements": [{
"date_reported": "1990-12-12T00:00:00.000Z",
"statement": "No consumer statement available."
}
],
"bank_accounts": [{
"account": "Personal checking",
"date_reported": "1990-12-12T00:00:00.000Z",
"creditor_entity": "RBC",
"account_number": "123asd",
"figure_amount": 1000.12,
"date_opened": "1990-12-12T00:00:00.000Z",
"account_type": "Checking",
"status": "active",
"number_of_nsf": 0
}
],
"local_inquiries": [{
"inquiry_date": "1990-12-12T00:00:00.000Z",
"customer_name": "Certn"
}
],
"foreign_inquiries": [{
"inquiry_date": "1990-12-12T00:00:00.000Z",
"city_name_or_inquiry_number": "Seattle",
"inquiry_province": "WA"
}
]
},
"identity_verified": true,
"employment_verified": true,
"identity_verification": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"status": "A",
"result": "VERIFIED"
},
"enhanced_identity_verification": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"status": "A",
"result": "VERIFIED"
},
"manual_id_verification": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"status": "A",
"result": "VERIFIED"
},
"rcmp_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"us_criminal_record_check_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"criminal_cases": [{
"case_type": "Criminal",
"number": "123asd",
"file_date": "2000-12-12",
"judgment_date": "2000-12-12",
"summary_description": "The case filings summary description",
"full_description": "string",
"notes": "No additional case notes available",
"court": {
"court": "Seattle Superior Court",
"court_type": "Criminal",
"docket_number": "545fjd",
"filed_date": "2000-12-12",
"served_date": "2000-12-12",
"trial_date": "2000-12-12",
"jurisdiction": "Seattle County"
},
"criminal_charges": [{
"offense_description": "Breach of peace",
"offense_date": "2000-12-12",
"offense_type": "Felony",
"plea": "Not Guilty",
"hearing_date": "2000-12-12",
"hearing_type": "Open court hearing",
"probation": "No probation given",
"community_service": "No community service given",
"sentence_suspended": "None",
"fines": "No fines given",
"fines_paid_status": "Fines not paid",
"fines_paid_date": "2000-12-12",
"cost": "200",
"restitution": "None",
"transferred_jurisdiction": "Transferred from Seattle",
"transferred_case_number": "690330",
"active_warrant": "No active warrant",
"jail_time": "6 months jail time",
"prison_time": "6 months prison time",
"charge_in_progress": "no charge in progress",
"charge": "Vehicular manslaughter two counts",
"charge_level": "Felony",
"charge_class": "None",
"dispositions": [{
"offense_description": "Speeding",
"offense_type": "Infraction",
"offense_date": "2000-12-12",
"description": "Description of the disposition offense",
"disposition_date": "2000-12-12",
"statue": "20-1212(B)",
"offense_class": "The offense class description",
"final_plea": "Not Guilty",
"disposition_description": "The description of the dispostion"
}
],
"arrests": [{
"arrest_date": "2000-12-12",
"booking_number": "42069",
"citation_number": "247365",
"arresting_agency": "KERSHAW COUNTY DETENTION CENTER",
"offense_type": "Misdemeanor",
"offense_description": "A description of the arresting offense",
"counts": "Arrest has 6 counts"
}
],
"sentences": [{
"sentence_type": "Community Service and Fines",
"duration": "6 months",
"amount": "100",
"amount_paid": "50",
"paid": "Half the fine has been paid",
"qualifier": "The sentence has no qualifier information",
"description": "The sentence description",
"effective_date": "2000-12-12",
"appearance_date": "2000-12-12",
"appearance_finding": "There are no appearance findings to detail about the sentence"
}
],
"additional_informations": [{
"description": "More case information was found.",
"additional_description": "None",
"event_date": "2000-12-12"
}
]
}
]
}
],
"ssn_id_document_reports": [{
"ssn_result": "Discrepancy",
"ssn_status": "Complete",
"names": [{
"first_name": "string",
"middle_name": "string",
"last_name": "string"
}
],
"addresses": [{
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2"
}
],
"id_documents": [{
"type": "Passport",
"number": "123412kdsdsk",
"issuing_country": "US",
"issuing_province_state": "WA",
"issue_date": "2000-12-12",
"expiry_date": "2000-12-12"
}
],
"dates_of_birth": [{
"date_of_birth": "2000-12-12"
}
]
}
],
"scan_status": {
"national_sex_offender_registry_scan": "Complete",
"security_watch_list_scan": "Complete",
"fraud_scan": "Complete",
"ofac_global_sanctions_scan": "Complete",
"ssn_verification_scan": "Complete",
"criminal_record_scan": "Complete",
"federal_record_scan": "Incomplete",
"single_state_county_record_scan": "Incomplete",
"all_state_county_record_scan": "Incomplete"
},
"record_check_requests": [{
"status": "Complete",
"state": "OH",
"county": "Kershaw",
"district": "District 1",
"fips_code": 12312,
"search_type": "Criminal/Court Database Search"
}
]
},
"verification_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"employment_verification": "VERIFIED",
"education_verification": "VERIFIED",
"credential_verification": "VERIFIED",
"certn_verification": "VERIFIED",
"employer_verification_results": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"certn_verification": "VERIFIED",
"company_name_verified": false,
"position_name_verified": false,
"income_verified": false,
"employment_dates_verified": true,
"verification_notes": "Verification notes!",
"employer": {
"company_name": "string",
"position": "string",
"income": 8500,
"pay_period": "PER_HOUR",
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string",
"employer_reference": {
"email": {
"address": "email@certn.co"
},
"phone_number": {
"phone_type": "NONE",
"number": "+1 250 555 1234",
"country": "string"
},
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
},
"contact": {
"can_contact": true,
"can_contact_after_date": "2021-11-12"
}
}
}
},
"education_verification_results": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"certn_verification": "VERIFIED",
"specializations_verified": false,
"degree_verified": false,
"institution_verified": false,
"enrolment_dates_verified": true,
"verification_notes": "Verification notes!",
"education": {
"institution": "string",
"degree": {
"degree": "2021-11-12",
"verified": true
},
"address": {
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2"
},
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string"
}
},
"credential_verification_results": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"certn_verification": "VERIFIED",
"certification_date_verified": false,
"certification_verified": false,
"institution_verified": true,
"verification_notes": "Verification notes!",
"credential": {
"description": "string",
"institution": "string",
"certification": "string",
"date_of_certification": "2021-11-12",
"current": true,
"certn_verification": "VERIFIED",
"verification_notes": "string"
}
}
},
"international_criminal_record_check_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"motor_vehicle_record_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"damage_to_property": 0,
"damage_to_property_label": "High",
"eviction_potential": 0,
"eviction_potential_label": "High",
"late_rent_potential": 0,
"late_rent_potential_label": "High",
"tenancy_length": 0,
"tenancy_length_label": "High"
}
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="400: Bad Request Missing field, wrong data type, account not configured" %}
This may be happening because:
**You are missing required fields**
Add all the required fields to the body of your request.
**You used the wrong format or data type for a field**
Format all your fields according to their [data type](https://www.w3schools.com/js/js_json_datatypes.asp).
**Your account isn't configured to run this check**
[Contact our support team](https://docs.certn.co/api/certn-api-v-1.0/contact#api) to have your account configured for this check.
*See* [#400-bad-request](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#400-bad-request "mention") *for more details.*
{% endtab %}
{% tab title="500: Internal Server Error Wrong data type" %}
This may be happening because:
**You used the wrong format or data type for a field**
Format all your fields according to their [data type](https://www.w3schools.com/js/js_json_datatypes.asp). Most fields in our API take strings, while request flags take booleans.
*See* [#500-internal-server-error](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#500-internal-server-error "mention") *for more details.*
{% endtab %}
{% endtabs %}
## Upgrade an application
`PUT` `https://api.certn.co/api/v2/applicants/{applicant_id}/packages/`
Add a screening request to an existing application.
To add screening requests to your application, wait for the report's `status` field to show `Returned`.
#### Path Parameters
| Name | Type | Description |
| ----------------------------------------------- | ------ | ------------------- |
| applicant\_id\* | string | ID of the applicant |
#### Request Body
| Name | Type | Description |
| ------------------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------- |
| tag | string | Group related applications by tag |
| {request\_flag}\* | boolean | [request-flags](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters/request-flags "mention") |
{% tabs %}
{% tab title="200: OK Application successfully retrieved" %}
{% tabs %}
{% tab title="Response type" %}
{% code title="application/json" %}
```json
{
"id": string ,
"created": string ,
"modified": string ,
"tag": string,
"(request_flags)": boolean
"last_updated": string ,
"submitted_time": string ,
"is_submitted": boolean,
"applicant_type": string ,
"report_status": string ,
"status": string ,
"status_label": string ,
"result": string ,
"result_label": string ,
"certn_score": number,
"certn_score_label": string ,
"applicant_account": {
"id": string,
"email": string
},
"application": {
object (Application)
},
"country": "CA",
"information": {
object (Information)
},
"employment_verification": string ,
"education_verification": string ,
"credential_verification": string ,
"reference_result": {
object (BasePackageResult)
},
"information_result": {
object (BasePackageResult)
},
"risk_result": {
object (RiskResult)
},
"equifax_result": {
object (EquifaxResult)
},
"identity_verified": boolean,
"employment_verified": boolean,
"identity_verification": {
object (Identity Verification)
},
"enhanced_identity_verification": {
object (EnhancedIdentityVerification)
},
"manual_id_verification": {
object (ManualIDVerification)
},
"rcmp_result": {
object (BasePackageResult)
},
"us_criminal_record_check_result": {
object (USCriminalRecordCheckResult)
},
"verification_result": {
object (VerificationResult)
},
"international_criminal_record_check_result": {
object (BasePackageResult)
},
"motor_vehicle_record_result": {
object (BasePackageResult)
},
"salary": number,
"sufficient_salary": boolean,
"high_risk_vulnerable_sector": boolean,
"job_safety_undue_risk": boolean,
"early_termination": number,
"early_termination_label": string ,
"reliability_risk": number,
"reliability_risk_label": string ,
"workplace_misconduct": number,
"workplace_misconduct_label": string
}
```
{% endcode %}
{% endtab %}
{% tab title="Example" %}
{% code title="application/json" %}
```json
{
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"tag": "Sub-Client 123",
"request_base": false,
"request_behavioural": false,
"request_softcheck": true,
"request_us_ssn_verification": false,
"request_equifax": true,
"request_identity_verification": false,
"request_enhanced_identity_verification": false,
"request_criminal_record_check": false,
"request_enhanced_criminal_record_check": false,
"request_us_criminal_record_check_tier_1": false,
"request_us_criminal_record_check_tier_2": false,
"request_us_criminal_record_check_tier_3": false,
"request_international_criminal_record_check": false,
"request_motor_vehicle_records": false,
"request_employment_verification": false,
"request_education_verification": false,
"request_credential_verification": false,
"request_employer_references": false,
"request_address_references": false,
"request_employer_phone_references": false,
"request_address_phone_references": false,
"request_instant_verify_employment": false,
"request_instant_verify_education": false,
"request_instant_verify_credential": false,
"last_updated": "2021-11-12T21:21:50Z",
"submitted_time": "2021-11-12T21:21:50Z",
"is_submitted": true,
"applicant_type": "STANDARD",
"report_status": "IN_PROGRESS",
"status": "Pending",
"status_label": "Pending",
"result": "REVIEW",
"result_label": "Review",
"certn_score": 85,
"certn_score_label": "PASS",
"applicant_account": {
"id": "string",
"email": "string"
},
"application": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"email": "string"
},
"country": "CA",
"information": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"first_name": "Sebastien",
"middle_name": "Jack Pierre",
"last_name": "Normandin",
"last_name_at_birth": "string",
"former_names": "string",
"alias": "string",
"date_of_birth": "2021-11-12",
"phone_number": "250-123-1234",
"sin_ssn": 123123123,
"gender": "M",
"birth_city": "string",
"birth_province_state": "string",
"birth_other_province_state": "string",
"birth_country": "string",
"license_number": "string",
"license_valid": true,
"license_prov_state": "string",
"license_other_country": true,
"license_type": "CA",
"cover_letter": "string",
"addresses": [
{
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2",
"rent_or_own": "R",
"cost": 0,
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string",
"address_reference": {
"email": {
"address": "email@certn.co"
},
"phone_number": {
"phone_type": "NONE",
"number": "+1 250 555 1234",
"country": "string"
},
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
},
"contact": {
"can_contact": true,
"can_contact_after_date": "2021-11-12"
}
}
}
],
"employers": [
{
"company_name": "string",
"position": "string",
"income": 8500,
"pay_period": "PER_HOUR",
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string",
"employer_reference": {
"email": {
"address": "email@certn.co"
},
"phone_number": {
"phone_type": "NONE",
"number": "+1 250 555 1234",
"country": "string"
},
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
},
"contact": {
"can_contact": true,
"can_contact_after_date": "2021-11-12"
}
}
}
],
"educations": [
{
"institution": "string",
"degree": {
"degree": "2021-11-12",
"verified": true
},
"address": {
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2"
},
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string"
}
],
"convictions": [
{
"offense": 2002,
"date_of_sentence": "2000-01-01T00:00:00.000Z",
"court_location": "Toronto, ON, Canada",
"description": "Robbery; Theft over $200"
}
]
},
"employment_verification": "VERIFIED",
"education_verification": "VERIFIED",
"credential_verification": "VERIFIED",
"reference_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"information_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"behavioural_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"risk_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"risk_evaluations": [
{
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"overall_score": "PASS",
"risk_information_result": {},
"criminal_results": [
{
"confidence": 0,
"confidence_label": "Likely",
"overall_score": "PASS",
"criminal_identity": {
"criminal_cases": [
{
"case_type": "Criminal",
"number": "123asd",
"file_date": "2000-12-12",
"judgment_date": "2000-12-12",
"summary_description": "The case filings summary description",
"full_description": "string",
"notes": "No additional case notes available",
"court": {
"court": "Seattle Superior Court",
"court_type": "Criminal",
"docket_number": "545fjd",
"filed_date": "2000-12-12",
"served_date": "2000-12-12",
"trial_date": "2000-12-12",
"jurisdiction": "Seattle County"
},
"criminal_charges": [
{
"offense_description": "Breach of peace",
"offense_date": "2000-12-12",
"offense_type": "Felony",
"plea": "Not Guilty",
"hearing_date": "2000-12-12",
"hearing_type": "Open court hearing",
"probation": "No probation given",
"community_service": "No community service given",
"sentence_suspended": "None",
"fines": "No fines given",
"fines_paid_status": "Fines not paid",
"fines_paid_date": "2000-12-12",
"cost": "200",
"restitution": "None",
"transferred_jurisdiction": "Transferred from Seattle",
"transferred_case_number": "690330",
"active_warrant": "No active warrant",
"jail_time": "6 months jail time",
"prison_time": "6 months prison time",
"charge_in_progress": "no charge in progress",
"charge": "Vehicular manslaughter two counts",
"charge_level": "Felony",
"charge_class": "None",
"dispositions": [
{
"offense_description": "Speeding",
"offense_type": "Infraction",
"offense_date": "2000-12-12",
"description": "Description of the disposition offense",
"disposition_date": "2000-12-12",
"statue": "20-1212(B)",
"offense_class": "The offense class description",
"final_plea": "Not Guilty",
"disposition_description": "The description of the dispostion"
}
],
"arrests": [
{
"arrest_date": "2000-12-12",
"booking_number": "42069",
"citation_number": "247365",
"arresting_agency": "KERSHAW COUNTY DETENTION CENTER",
"offense_type": "Misdemeanor",
"offense_description": "A description of the arresting offense",
"counts": "Arrest has 6 counts"
}
],
"sentences": [
{
"sentence_type": "Community Service and Fines",
"duration": "6 months",
"amount": "100",
"amount_paid": "50",
"paid": "Half the fine has been paid",
"qualifier": "The sentence has no qualifier information",
"description": "The sentence description",
"effective_date": "2000-12-12",
"appearance_date": "2000-12-12",
"appearance_finding": "There are no appearance findings to detail about the sentence"
}
],
"additional_informations": [
{
"description": "More case information was found.",
"additional_description": "None",
"event_date": "2000-12-12"
}
]
}
]
}
],
"criminal_alerts": [
{
"parent_category": "FRAUD",
"category": "Burglary",
"stage": "Conviction",
"type": "Citation",
"description": "Convicted of burglary",
"date": "2000-12-12",
"parent_category_label": "Fraud"
}
],
"criminal_sources": [
{
"name": "World News",
"url": "worldnews.com",
"date": "2000-12-12",
"format": "Online Media",
"headline": "Burglary Conviction for Area Man",
"publication_source": "World News Conglomerate",
"publisher": "World News"
}
],
"criminal_addresses": [
{
"start_date": "2000-12-12",
"end_date": "2000-12-12",
"unit": "1a",
"address": "123 fort st.",
"city": "Victoria",
"province_state": "BC",
"country": "Canda",
"postal_code": "V8X2C3"
}
],
"criminal_additional_informations": [
{
"aliases": [
"willy will",
"billy bill"
],
"dates_of_birth": [
"2000-12-12"
],
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
}
}
]
}
}
]
}
]
},
"equifax_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"description": "The financial score is based on self-provided information from the applicant and an analysis of the applicant's information available to Certn. This includes a credit check, Equifax record analysis, as well as other important informational data points",
"total_debt": 100,
"upgradable": false,
"trades": [
{
"credit_grantor": "RBC",
"payment_status": "Up to date",
"date_opened": "2000-12-12",
"account_rating": "High",
"date_reported": "2000-12-12",
"account_type": "Revolving",
"high_credit": 2000,
"balance_amount": 1000,
"last_activity_or_payment": "Paid as up to date",
"r_code": "R-1",
"percent_credit_used": 50,
"account_number": "112ksjd",
"past_due_amount": 0,
"payment_term_amount": 120,
"months_reviewed": 15,
"narratives": [
"Account has been paid in full."
]
}
],
"employers": [
{
"employment": "Subject's Current Employer",
"occupation": "Software",
"employer": "Certn",
"city": "Victoria",
"province": "BC",
"verification": true,
"salary": 1000000
}
],
"addresses": [
{
"address": "123 fort st.",
"civic_number": 123,
"street_name": "fort st.",
"city": "Victoria",
"province": "BC"
}
],
"collections": [
{
"date_of_last_payment": "2000-12-12",
"creditor": "Boys Club",
"amount_owed": 10000,
"amount_paid": 50,
"ledger_number": "123aslld",
"date_paid": "2000-12-12T00:00:00.000Z",
"date_reported": "2000-12-12T00:00:00.000Z",
"assigned_date": "2012-12-12T00:00:00.000Z",
"verification_date": "2000-12-12T00:00:00.000Z",
"account_designation": "Individual",
"first_deliquency": "2000-12-12T00:00:00.000Z",
"agency_entity": "GQC123",
"reason": "Credit not paid on in full",
"description": "Parking ticket"
}
],
"deposit_alerts": [
{
"customer_entity": "RBC",
"date_reported": "2000-12-12T00:00:00.000Z",
"account_type": "Business",
"date_opened": "2000-12-12T00:00:00.000Z",
"date_closed": "2000-12-12T00:00:00.000Z",
"date_written_off": "2000-12-12T00:00:00.000Z",
"amount_written_off": 2000,
"alert_status": "High",
"alert_status_date": "2000-12-12T00:00:00.000Z"
}
],
"bankruptcies": [
{
"account_type": "Individual",
"liability_amount": 2000,
"asset_amount": 20000,
"customer": "CRED COUNSELLING SOC",
"case_number_and_trustee": "12312 CE ASSOCIATES",
"filer": "Subject",
"legal_narrative": "No legal information available",
"date_filed": "2000-12-12T00:00:00.000Z",
"intent_or_disposition": "Discharged"
}
],
"judgments": [
{
"plaintiff": "Fred Rickleson",
"defendant": "Rick Frederickson",
"amount": 1000.21,
"date_filed": "2000-12-12T00:00:00.000Z",
"date_satisfied": "2000-12-12T00:00:00.000Z",
"verification_date": "2000-12-12T00:00:00.000Z",
"court_entity": "RBC",
"garnishee": "RBC",
"description": "Fred sued Rick"
}
],
"legal_items": [
{
"case_number": "1232djdsj",
"verification_date": "2000-12-12T00:00:00.000Z",
"update_source_code": "Tape rptd",
"date_filed": "2000-12-12T00:00:00.000Z",
"court_entity": "Toronto small claims",
"status_code": "Satisfied",
"date_satisfied": "2000-12-12T00:00:00.000Z",
"amount": 10000,
"defendant": "John Smithy",
"plaintiff": "Smith Johny",
"lawyer_name_address": "Johnson LLC 123 fort st Victoria",
"legal_item_description": "It was very bad deal"
}
],
"liens": [
{
"amount": 1000,
"date_filed": "1999-12-12T00:00:00.000Z",
"lien_class": "Class A",
"date_released": "1990-12-12T00:00:00.000Z",
"date_verified": "1990-12-12T00:00:00.000Z",
"court_entity": "Superior Court.",
"case_number": "123asda",
"lien_description": "Lien on house."
}
],
"secured_loans": [
{
"date_filed": "1990-12-12T00:00:00.000Z",
"court_entity": "Superior",
"creditor_name_address": "RBC 123 Main st.",
"creditor_industry_code": "620a",
"maturity_date": "1990-12-12T00:00:00.000Z"
}
],
"fraud_warnings": [
{
"product_description": "Fraud warnings are warnings of fraud.",
"message_priority": "Very high",
"message_code": "123a",
"message_description": "High fraud alert for bank fraud"
}
],
"non_sufficient_funds": [
{
"date_reported": "1990-12-12T00:00:00.000Z",
"creditor_entity": "RBC",
"nsfamount": 1000.2,
"details": "No sufficient funds in savings account.",
"verification_date": "1990-12-12T00:00:00.000Z"
}
],
"credit_file_metadatas": [
{
"hit_strength_indicator": "HIT",
"request_number": "123asd",
"address_discrepancy": "No discrepancy found in address",
"customer_number": "123asd",
"report_id": "123asd",
"file_since_date": "1990-12-12T00:00:00.000Z",
"date_of_last_activity": "1990-12-12T00:00:00.000Z",
"date_of_request": "1990-12-12T00:00:00.000Z",
"hit": "Big Hit",
"data_warning_messages": [
"No data warning messages"
],
"card_alert_warning_messages": [
"Credit card on high alert"
],
"alert_indicators": [
"No messages"
]
}
],
"other_incomes": [
{
"date_reported": "1990-12-12T00:00:00.000Z",
"income_source": "RBC",
"amount": 1000000,
"verification_date": "1990-12-12T00:00:00.000Z"
}
],
"consumer_statements": [
{
"date_reported": "1990-12-12T00:00:00.000Z",
"statement": "No consumer statement available."
}
],
"bank_accounts": [
{
"account": "Personal checking",
"date_reported": "1990-12-12T00:00:00.000Z",
"creditor_entity": "RBC",
"account_number": "123asd",
"figure_amount": 1000.12,
"date_opened": "1990-12-12T00:00:00.000Z",
"account_type": "Checking",
"status": "active",
"number_of_nsf": 0
}
],
"local_inquiries": [
{
"inquiry_date": "1990-12-12T00:00:00.000Z",
"customer_name": "Certn"
}
],
"foreign_inquiries": [
{
"inquiry_date": "1990-12-12T00:00:00.000Z",
"city_name_or_inquiry_number": "Seattle",
"inquiry_province": "WA"
}
]
},
"identity_verified": true,
"employment_verified": true,
"identity_verification": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"status": "A",
"result": "VERIFIED"
},
"enhanced_identity_verification": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"status": "A",
"result": "VERIFIED"
},
"manual_id_verification": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"status": "A",
"result": "VERIFIED"
},
"rcmp_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"us_criminal_record_check_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"criminal_cases": [
{
"case_type": "Criminal",
"number": "123asd",
"file_date": "2000-12-12",
"judgment_date": "2000-12-12",
"summary_description": "The case filings summary description",
"full_description": "string",
"notes": "No additional case notes available",
"court": {
"court": "Seattle Superior Court",
"court_type": "Criminal",
"docket_number": "545fjd",
"filed_date": "2000-12-12",
"served_date": "2000-12-12",
"trial_date": "2000-12-12",
"jurisdiction": "Seattle County"
},
"criminal_charges": [
{
"offense_description": "Breach of peace",
"offense_date": "2000-12-12",
"offense_type": "Felony",
"plea": "Not Guilty",
"hearing_date": "2000-12-12",
"hearing_type": "Open court hearing",
"probation": "No probation given",
"community_service": "No community service given",
"sentence_suspended": "None",
"fines": "No fines given",
"fines_paid_status": "Fines not paid",
"fines_paid_date": "2000-12-12",
"cost": "200",
"restitution": "None",
"transferred_jurisdiction": "Transferred from Seattle",
"transferred_case_number": "690330",
"active_warrant": "No active warrant",
"jail_time": "6 months jail time",
"prison_time": "6 months prison time",
"charge_in_progress": "no charge in progress",
"charge": "Vehicular manslaughter two counts",
"charge_level": "Felony",
"charge_class": "None",
"dispositions": [
{
"offense_description": "Speeding",
"offense_type": "Infraction",
"offense_date": "2000-12-12",
"description": "Description of the disposition offense",
"disposition_date": "2000-12-12",
"statue": "20-1212(B)",
"offense_class": "The offense class description",
"final_plea": "Not Guilty",
"disposition_description": "The description of the dispostion"
}
],
"arrests": [
{
"arrest_date": "2000-12-12",
"booking_number": "42069",
"citation_number": "247365",
"arresting_agency": "KERSHAW COUNTY DETENTION CENTER",
"offense_type": "Misdemeanor",
"offense_description": "A description of the arresting offense",
"counts": "Arrest has 6 counts"
}
],
"sentences": [
{
"sentence_type": "Community Service and Fines",
"duration": "6 months",
"amount": "100",
"amount_paid": "50",
"paid": "Half the fine has been paid",
"qualifier": "The sentence has no qualifier information",
"description": "The sentence description",
"effective_date": "2000-12-12",
"appearance_date": "2000-12-12",
"appearance_finding": "There are no appearance findings to detail about the sentence"
}
],
"additional_informations": [
{
"description": "More case information was found.",
"additional_description": "None",
"event_date": "2000-12-12"
}
]
}
]
}
],
"ssn_id_document_reports": [
{
"ssn_result": "Discrepancy",
"ssn_status": "Complete",
"names": [
{
"first_name": "string",
"middle_name": "string",
"last_name": "string"
}
],
"addresses": [
{
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2"
}
],
"id_documents": [
{
"type": "Passport",
"number": "123412kdsdsk",
"issuing_country": "US",
"issuing_province_state": "WA",
"issue_date": "2000-12-12",
"expiry_date": "2000-12-12"
}
],
"dates_of_birth": [
{
"date_of_birth": "2000-12-12"
}
]
}
],
"scan_status": {
"national_sex_offender_registry_scan": "Complete",
"security_watch_list_scan": "Complete",
"fraud_scan": "Complete",
"ofac_global_sanctions_scan": "Complete",
"ssn_verification_scan": "Complete",
"criminal_record_scan": "Complete",
"federal_record_scan": "Incomplete",
"single_state_county_record_scan": "Incomplete",
"all_state_county_record_scan": "Incomplete"
},
"record_check_requests": [
{
"status": "Complete",
"state": "OH",
"county": "Kershaw",
"district": "District 1",
"fips_code": 12312,
"search_type": "Criminal/Court Database Search"
}
]
},
"verification_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"employment_verification": "VERIFIED",
"education_verification": "VERIFIED",
"credential_verification": "VERIFIED",
"certn_verification": "VERIFIED",
"employer_verification_results": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"certn_verification": "VERIFIED",
"company_name_verified": false,
"position_name_verified": false,
"income_verified": false,
"employment_dates_verified": true,
"verification_notes": "Verification notes!",
"employer": {
"company_name": "string",
"position": "string",
"income": 8500,
"pay_period": "PER_HOUR",
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string",
"employer_reference": {
"email": {
"address": "email@certn.co"
},
"phone_number": {
"phone_type": "NONE",
"number": "+1 250 555 1234",
"country": "string"
},
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
},
"contact": {
"can_contact": true,
"can_contact_after_date": "2021-11-12"
}
}
}
},
"education_verification_results": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"certn_verification": "VERIFIED",
"specializations_verified": false,
"degree_verified": false,
"institution_verified": false,
"enrolment_dates_verified": true,
"verification_notes": "Verification notes!",
"education": {
"institution": "string",
"degree": {
"degree": "2021-11-12",
"verified": true
},
"address": {
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2"
},
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string"
}
},
"credential_verification_results": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"certn_verification": "VERIFIED",
"certification_date_verified": false,
"certification_verified": false,
"institution_verified": true,
"verification_notes": "Verification notes!",
"credential": {
"description": "string",
"institution": "string",
"certification": "string",
"date_of_certification": "2021-11-12",
"current": true,
"certn_verification": "VERIFIED",
"verification_notes": "string"
}
}
},
"international_criminal_record_check_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"motor_vehicle_record_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"instant_verify_result": {
"instant_verify_employment": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"instant_verify_employment_result": [
{
"verification_status": "VERIFIED",
"verifications_scale": 0.8,
"label_source_data": "Tiger Keeping",
"label_verifier_data": "Keeping of Tigers",
"org_source_data": "The Greater Wynnewood Exotic Animal Park",
"org_verifier_data": "The Greater Wynnewood Exotic Animal Park",
"dates_source_data": "Feb - Sept 2020",
"dates_verifier_data": "Feb - Sept 2020"
}
]
},
"instant_verify_education": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"instant_verify_education_result": [
{
"verification_status": "VERIFIED",
"verifications_scale": 0.8,
"label_source_data": "Exploring Level 1",
"label_verifier_data": "Exploring 1",
"org_source_data": "DZ Center",
"org_verifier_data": "DZ Center",
"dates_source_data": "Feb - Sept 2020",
"dates_verifier_data": "Feb - Sept 2020"
}
]
},
"instant_verify_credential": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"instant_verification_credential_result": [
{
"verification_status": "VERIFIED",
"verifications_scale": 0.8,
"label_source_data": "CPR",
"label_verifier_data": "CPR Care Giver",
"org_source_data": "Red Cross",
"org_verifier_data": "Red Cross",
"dates_source_data": "Feb - Sept 2020",
"dates_verifier_data": "Feb - Sept 2020"
}
]
}
},
"damage_to_property": 0,
"damage_to_property_label": "High",
"eviction_potential": 0,
"eviction_potential_label": "High",
"late_rent_potential": 0,
"late_rent_potential_label": "High",
"tenancy_length": 0,
"tenancy_length_label": "High"
}
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="400: Bad Request Account not configured" %}
This may be happening because:
**Your account isn't configured to run this check**
[Contact our support team](https://docs.certn.co/api/certn-api-v-1.0/contact#api) to have your account configured for this check.
*See* [#400-bad-request](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#400-bad-request "mention") *for more details.*
{% endtab %}
{% endtabs %}
## Retrieve all your applications
`GET` `https://api.certn.co/api/v2/applicants/`
View the details of all your applications.
The results are sent via paginated response, in chronological order. To retrieve the next page, send a request to the URL under the field `next`, or add one to your page counter:
`https://api.certn.co/api/v2/applicants/?page=`
You can retrieve the final report for an application when its `report_status` field is marked as `COMPLETE`.
#### Query Parameters
| Name | Type | Description |
| ---- | ---- | ----------------------- |
| page | int | Page number to retrieve |
{% tabs %}
{% tab title="200: OK Reports successfully retrieved" %}
{% tabs %}
{% tab title="Response type" %}
{% code title="application/json" %}
```json
{
"count": int,
"next": string,
"previous": string,
"results": [,
"id": string < uuid > ,
"created": string < date - time > ,
"modified": string < date - time > ,
"tag": string,
"(request_flags)": boolean
"last_updated": string < date - time > ,
"submitted_time": string < date - time > ,
"is_submitted": boolean,
"applicant_type": string < Enum > ,
"report_status": string < Enum > ,
"status": string < Enum > ,
"status_label": string < Enum > ,
"result": string < Enum > ,
"result_label": string < Enum > ,
"certn_score": number,
"certn_score_label": string < Enum > ,
"applicant_account": {
"id": string,
"email": string
},
"application": {
object(Application)
},
"country": "CA",
"information": {
object(Information)
},
"employment_verification": string < VerificationEnum > ,
"education_verification": string < VerificationEnum > ,
"credential_verification": string < VerificationEnum > ,
"reference_result": {
object(BasePackageResult)
},
"information_result": {
object(BasePackageResult)
},
"risk_result": {
object(RiskResult)
},
"equifax_result": {
object(EquifaxResult)
},
"identity_verified": boolean,
"employment_verified": boolean,
"identity_verification": {
object(Identity Verification)
},
"enhanced_identity_verification": {
object(EnhancedIdentityVerification)
},
"manual_id_verification": {
object(ManualIDVerification)
},
"rcmp_result": {
object(BasePackageResult)
},
"us_criminal_record_check_result": {
object(USCriminalRecordCheckResult)
},
"verification_result": {
object(VerificationResult)
},
"international_criminal_record_check_result": {
object(BasePackageResult)
},
"motor_vehicle_record_result": {
object(BasePackageResult)
},
"salary": number,
"sufficient_salary": boolean,
"high_risk_vulnerable_sector": boolean,
"job_safety_undue_risk": boolean,
"early_termination": number,
"early_termination_label": string < Enum > ,
"reliability_risk": number,
"reliability_risk_label": string < Enum > ,
"workplace_misconduct": number,
"workplace_misconduct_label": string < Enum >
}
]
}
```
{% endcode %}
{% endtab %}
{% tab title="Example" %}
{% code title="application/json" %}
```json
{
"count": 38058,
"next": "http://api.certn.co/api/v2/applicants/?page=2",
"previous": null,
"results": [{
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"tag": "Sub-Client 123",
"request_base": false,
"request_behavioural": false,
"request_softcheck": true,
"request_us_ssn_verification": false,
"request_equifax": true,
"request_identity_verification": false,
"request_enhanced_identity_verification": false,
"request_criminal_record_check": false,
"request_enhanced_criminal_record_check": false,
"request_us_criminal_record_check_tier_1": false,
"request_us_criminal_record_check_tier_2": false,
"request_us_criminal_record_check_tier_3": false,
"request_international_criminal_record_check": false,
"request_motor_vehicle_records": false,
"request_employment_verification": false,
"request_education_verification": false,
"request_credential_verification": false,
"request_employer_references": false,
"request_address_references": false,
"request_employer_phone_references": false,
"request_address_phone_references": false,
"request_instant_verify_employment": false,
"request_instant_verify_education": false,
"request_instant_verify_credential": false,
"last_updated": "2021-11-12T21:21:50Z",
"submitted_time": "2021-11-12T21:21:50Z",
"is_submitted": true,
"applicant_type": "STANDARD",
"report_status": "IN_PROGRESS",
"status": "Pending",
"status_label": "Pending",
"result": "REVIEW",
"result_label": "Review",
"certn_score": 85,
"certn_score_label": "PASS",
"applicant_account": {
"id": "string",
"email": "string"
},
"application": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"email": "string"
},
"country": "CA",
"information": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"first_name": "Sebastien",
"middle_name": "Jack Pierre",
"last_name": "Normandin",
"last_name_at_birth": "string",
"former_names": "string",
"alias": "string",
"date_of_birth": "2021-11-12",
"phone_number": "250-123-1234",
"sin_ssn": 123123123,
"gender": "M",
"birth_city": "string",
"birth_province_state": "string",
"birth_other_province_state": "string",
"birth_country": "string",
"license_number": "string",
"license_valid": true,
"license_prov_state": "string",
"license_other_country": true,
"license_type": "CA",
"cover_letter": "string",
"addresses": [{
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2",
"rent_or_own": "R",
"cost": 0,
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string",
"address_reference": {
"email": {
"address": "email@certn.co"
},
"phone_number": {
"phone_type": "NONE",
"number": "+1 250 555 1234",
"country": "string"
},
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
},
"contact": {
"can_contact": true,
"can_contact_after_date": "2021-11-12"
}
}
}
],
"employers": [{
"company_name": "string",
"position": "string",
"income": 8500,
"pay_period": "PER_HOUR",
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string",
"employer_reference": {
"email": {
"address": "email@certn.co"
},
"phone_number": {
"phone_type": "NONE",
"number": "+1 250 555 1234",
"country": "string"
},
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
},
"contact": {
"can_contact": true,
"can_contact_after_date": "2021-11-12"
}
}
}
],
"educations": [{
"institution": "string",
"degree": {
"degree": "2021-11-12",
"verified": true
},
"address": {
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2"
},
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string"
}
],
"convictions": [{
"offense": 2002,
"date_of_sentence": "2000-01-01T00:00:00.000Z",
"court_location": "Toronto, ON, Canada",
"description": "Robbery; Theft over $200"
}
]
},
"employment_verification": "VERIFIED",
"education_verification": "VERIFIED",
"credential_verification": "VERIFIED",
"reference_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"information_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"behavioural_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"risk_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"risk_evaluations": [{
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"overall_score": "PASS",
"risk_information_result": {},
"criminal_results": [{
"confidence": 0,
"confidence_label": "Likely",
"overall_score": "PASS",
"criminal_identity": {
"criminal_cases": [{
"case_type": "Criminal",
"number": "123asd",
"file_date": "2000-12-12",
"judgment_date": "2000-12-12",
"summary_description": "The case filings summary description",
"full_description": "string",
"notes": "No additional case notes available",
"court": {
"court": "Seattle Superior Court",
"court_type": "Criminal",
"docket_number": "545fjd",
"filed_date": "2000-12-12",
"served_date": "2000-12-12",
"trial_date": "2000-12-12",
"jurisdiction": "Seattle County"
},
"criminal_charges": [{
"offense_description": "Breach of peace",
"offense_date": "2000-12-12",
"offense_type": "Felony",
"plea": "Not Guilty",
"hearing_date": "2000-12-12",
"hearing_type": "Open court hearing",
"probation": "No probation given",
"community_service": "No community service given",
"sentence_suspended": "None",
"fines": "No fines given",
"fines_paid_status": "Fines not paid",
"fines_paid_date": "2000-12-12",
"cost": "200",
"restitution": "None",
"transferred_jurisdiction": "Transferred from Seattle",
"transferred_case_number": "690330",
"active_warrant": "No active warrant",
"jail_time": "6 months jail time",
"prison_time": "6 months prison time",
"charge_in_progress": "no charge in progress",
"charge": "Vehicular manslaughter two counts",
"charge_level": "Felony",
"charge_class": "None",
"dispositions": [{
"offense_description": "Speeding",
"offense_type": "Infraction",
"offense_date": "2000-12-12",
"description": "Description of the disposition offense",
"disposition_date": "2000-12-12",
"statue": "20-1212(B)",
"offense_class": "The offense class description",
"final_plea": "Not Guilty",
"disposition_description": "The description of the dispostion"
}
],
"arrests": [{
"arrest_date": "2000-12-12",
"booking_number": "42069",
"citation_number": "247365",
"arresting_agency": "KERSHAW COUNTY DETENTION CENTER",
"offense_type": "Misdemeanor",
"offense_description": "A description of the arresting offense",
"counts": "Arrest has 6 counts"
}
],
"sentences": [{
"sentence_type": "Community Service and Fines",
"duration": "6 months",
"amount": "100",
"amount_paid": "50",
"paid": "Half the fine has been paid",
"qualifier": "The sentence has no qualifier information",
"description": "The sentence description",
"effective_date": "2000-12-12",
"appearance_date": "2000-12-12",
"appearance_finding": "There are no appearance findings to detail about the sentence"
}
],
"additional_informations": [{
"description": "More case information was found.",
"additional_description": "None",
"event_date": "2000-12-12"
}
]
}
]
}
],
"criminal_alerts": [{
"parent_category": "FRAUD",
"category": "Burglary",
"stage": "Conviction",
"type": "Citation",
"description": "Convicted of burglary",
"date": "2000-12-12",
"parent_category_label": "Fraud"
}
],
"criminal_sources": [{
"name": "World News",
"url": "worldnews.com",
"date": "2000-12-12",
"format": "Online Media",
"headline": "Burglary Conviction for Area Man",
"publication_source": "World News Conglomerate",
"publisher": "World News"
}
],
"criminal_addresses": [{
"start_date": "2000-12-12",
"end_date": "2000-12-12",
"unit": "1a",
"address": "123 fort st.",
"city": "Victoria",
"province_state": "BC",
"country": "Canda",
"postal_code": "V8X2C3"
}
],
"criminal_additional_informations": [{
"aliases": [
"willy will",
"billy bill"
],
"dates_of_birth": [
"2000-12-12"
],
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
}
}
]
}
}
]
}
]
},
"equifax_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"description": "The financial score is based on self-provided information from the applicant and an analysis of the applicant's information available to Certn. This includes a credit check, Equifax record analysis, as well as other important informational data points",
"total_debt": 100,
"upgradable": false,
"trades": [{
"credit_grantor": "RBC",
"payment_status": "Up to date",
"date_opened": "2000-12-12",
"account_rating": "High",
"date_reported": "2000-12-12",
"account_type": "Revolving",
"high_credit": 2000,
"balance_amount": 1000,
"last_activity_or_payment": "Paid as up to date",
"r_code": "R-1",
"percent_credit_used": 50,
"account_number": "112ksjd",
"past_due_amount": 0,
"payment_term_amount": 120,
"months_reviewed": 15,
"narratives": [
"Account has been paid in full."
]
}
],
"employers": [{
"employment": "Subject's Current Employer",
"occupation": "Software",
"employer": "Certn",
"city": "Victoria",
"province": "BC",
"verification": true,
"salary": 1000000
}
],
"addresses": [{
"address": "123 fort st.",
"civic_number": 123,
"street_name": "fort st.",
"city": "Victoria",
"province": "BC"
}
],
"collections": [{
"date_of_last_payment": "2000-12-12",
"creditor": "Boys Club",
"amount_owed": 10000,
"amount_paid": 50,
"ledger_number": "123aslld",
"date_paid": "2000-12-12T00:00:00.000Z",
"date_reported": "2000-12-12T00:00:00.000Z",
"assigned_date": "2012-12-12T00:00:00.000Z",
"verification_date": "2000-12-12T00:00:00.000Z",
"account_designation": "Individual",
"first_deliquency": "2000-12-12T00:00:00.000Z",
"agency_entity": "GQC123",
"reason": "Credit not paid on in full",
"description": "Parking ticket"
}
],
"deposit_alerts": [{
"customer_entity": "RBC",
"date_reported": "2000-12-12T00:00:00.000Z",
"account_type": "Business",
"date_opened": "2000-12-12T00:00:00.000Z",
"date_closed": "2000-12-12T00:00:00.000Z",
"date_written_off": "2000-12-12T00:00:00.000Z",
"amount_written_off": 2000,
"alert_status": "High",
"alert_status_date": "2000-12-12T00:00:00.000Z"
}
],
"bankruptcies": [{
"account_type": "Individual",
"liability_amount": 2000,
"asset_amount": 20000,
"customer": "CRED COUNSELLING SOC",
"case_number_and_trustee": "12312 CE ASSOCIATES",
"filer": "Subject",
"legal_narrative": "No legal information available",
"date_filed": "2000-12-12T00:00:00.000Z",
"intent_or_disposition": "Discharged"
}
],
"judgments": [{
"plaintiff": "Fred Rickleson",
"defendant": "Rick Frederickson",
"amount": 1000.21,
"date_filed": "2000-12-12T00:00:00.000Z",
"date_satisfied": "2000-12-12T00:00:00.000Z",
"verification_date": "2000-12-12T00:00:00.000Z",
"court_entity": "RBC",
"garnishee": "RBC",
"description": "Fred sued Rick"
}
],
"legal_items": [{
"case_number": "1232djdsj",
"verification_date": "2000-12-12T00:00:00.000Z",
"update_source_code": "Tape rptd",
"date_filed": "2000-12-12T00:00:00.000Z",
"court_entity": "Toronto small claims",
"status_code": "Satisfied",
"date_satisfied": "2000-12-12T00:00:00.000Z",
"amount": 10000,
"defendant": "John Smithy",
"plaintiff": "Smith Johny",
"lawyer_name_address": "Johnson LLC 123 fort st Victoria",
"legal_item_description": "It was very bad deal"
}
],
"liens": [{
"amount": 1000,
"date_filed": "1999-12-12T00:00:00.000Z",
"lien_class": "Class A",
"date_released": "1990-12-12T00:00:00.000Z",
"date_verified": "1990-12-12T00:00:00.000Z",
"court_entity": "Superior Court.",
"case_number": "123asda",
"lien_description": "Lien on house."
}
],
"secured_loans": [{
"date_filed": "1990-12-12T00:00:00.000Z",
"court_entity": "Superior",
"creditor_name_address": "RBC 123 Main st.",
"creditor_industry_code": "620a",
"maturity_date": "1990-12-12T00:00:00.000Z"
}
],
"fraud_warnings": [{
"product_description": "Fraud warnings are warnings of fraud.",
"message_priority": "Very high",
"message_code": "123a",
"message_description": "High fraud alert for bank fraud"
}
],
"non_sufficient_funds": [{
"date_reported": "1990-12-12T00:00:00.000Z",
"creditor_entity": "RBC",
"nsfamount": 1000.2,
"details": "No sufficient funds in savings account.",
"verification_date": "1990-12-12T00:00:00.000Z"
}
],
"credit_file_metadatas": [{
"hit_strength_indicator": "HIT",
"request_number": "123asd",
"address_discrepancy": "No discrepancy found in address",
"customer_number": "123asd",
"report_id": "123asd",
"file_since_date": "1990-12-12T00:00:00.000Z",
"date_of_last_activity": "1990-12-12T00:00:00.000Z",
"date_of_request": "1990-12-12T00:00:00.000Z",
"hit": "Big Hit",
"data_warning_messages": [
"No data warning messages"
],
"card_alert_warning_messages": [
"Credit card on high alert"
],
"alert_indicators": [
"No messages"
]
}
],
"other_incomes": [{
"date_reported": "1990-12-12T00:00:00.000Z",
"income_source": "RBC",
"amount": 1000000,
"verification_date": "1990-12-12T00:00:00.000Z"
}
],
"consumer_statements": [{
"date_reported": "1990-12-12T00:00:00.000Z",
"statement": "No consumer statement available."
}
],
"bank_accounts": [{
"account": "Personal checking",
"date_reported": "1990-12-12T00:00:00.000Z",
"creditor_entity": "RBC",
"account_number": "123asd",
"figure_amount": 1000.12,
"date_opened": "1990-12-12T00:00:00.000Z",
"account_type": "Checking",
"status": "active",
"number_of_nsf": 0
}
],
"local_inquiries": [{
"inquiry_date": "1990-12-12T00:00:00.000Z",
"customer_name": "Certn"
}
],
"foreign_inquiries": [{
"inquiry_date": "1990-12-12T00:00:00.000Z",
"city_name_or_inquiry_number": "Seattle",
"inquiry_province": "WA"
}
]
},
"identity_verified": true,
"employment_verified": true,
"identity_verification": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"status": "A",
"result": "VERIFIED"
},
"enhanced_identity_verification": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"status": "A",
"result": "VERIFIED"
},
"manual_id_verification": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"status": "A",
"result": "VERIFIED"
},
"rcmp_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"us_criminal_record_check_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"criminal_cases": [{
"case_type": "Criminal",
"number": "123asd",
"file_date": "2000-12-12",
"judgment_date": "2000-12-12",
"summary_description": "The case filings summary description",
"full_description": "string",
"notes": "No additional case notes available",
"court": {
"court": "Seattle Superior Court",
"court_type": "Criminal",
"docket_number": "545fjd",
"filed_date": "2000-12-12",
"served_date": "2000-12-12",
"trial_date": "2000-12-12",
"jurisdiction": "Seattle County"
},
"criminal_charges": [{
"offense_description": "Breach of peace",
"offense_date": "2000-12-12",
"offense_type": "Felony",
"plea": "Not Guilty",
"hearing_date": "2000-12-12",
"hearing_type": "Open court hearing",
"probation": "No probation given",
"community_service": "No community service given",
"sentence_suspended": "None",
"fines": "No fines given",
"fines_paid_status": "Fines not paid",
"fines_paid_date": "2000-12-12",
"cost": "200",
"restitution": "None",
"transferred_jurisdiction": "Transferred from Seattle",
"transferred_case_number": "690330",
"active_warrant": "No active warrant",
"jail_time": "6 months jail time",
"prison_time": "6 months prison time",
"charge_in_progress": "no charge in progress",
"charge": "Vehicular manslaughter two counts",
"charge_level": "Felony",
"charge_class": "None",
"dispositions": [{
"offense_description": "Speeding",
"offense_type": "Infraction",
"offense_date": "2000-12-12",
"description": "Description of the disposition offense",
"disposition_date": "2000-12-12",
"statue": "20-1212(B)",
"offense_class": "The offense class description",
"final_plea": "Not Guilty",
"disposition_description": "The description of the dispostion"
}
],
"arrests": [{
"arrest_date": "2000-12-12",
"booking_number": "42069",
"citation_number": "247365",
"arresting_agency": "KERSHAW COUNTY DETENTION CENTER",
"offense_type": "Misdemeanor",
"offense_description": "A description of the arresting offense",
"counts": "Arrest has 6 counts"
}
],
"sentences": [{
"sentence_type": "Community Service and Fines",
"duration": "6 months",
"amount": "100",
"amount_paid": "50",
"paid": "Half the fine has been paid",
"qualifier": "The sentence has no qualifier information",
"description": "The sentence description",
"effective_date": "2000-12-12",
"appearance_date": "2000-12-12",
"appearance_finding": "There are no appearance findings to detail about the sentence"
}
],
"additional_informations": [{
"description": "More case information was found.",
"additional_description": "None",
"event_date": "2000-12-12"
}
]
}
]
}
],
"ssn_id_document_reports": [{
"ssn_result": "Discrepancy",
"ssn_status": "Complete",
"names": [{
"first_name": "string",
"middle_name": "string",
"last_name": "string"
}
],
"addresses": [{
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2"
}
],
"id_documents": [{
"type": "Passport",
"number": "123412kdsdsk",
"issuing_country": "US",
"issuing_province_state": "WA",
"issue_date": "2000-12-12",
"expiry_date": "2000-12-12"
}
],
"dates_of_birth": [{
"date_of_birth": "2000-12-12"
}
]
}
],
"scan_status": {
"national_sex_offender_registry_scan": "Complete",
"security_watch_list_scan": "Complete",
"fraud_scan": "Complete",
"ofac_global_sanctions_scan": "Complete",
"ssn_verification_scan": "Complete",
"criminal_record_scan": "Complete",
"federal_record_scan": "Incomplete",
"single_state_county_record_scan": "Incomplete",
"all_state_county_record_scan": "Incomplete"
},
"record_check_requests": [{
"status": "Complete",
"state": "OH",
"county": "Kershaw",
"district": "District 1",
"fips_code": 12312,
"search_type": "Criminal/Court Database Search"
}
]
},
"verification_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"employment_verification": "VERIFIED",
"education_verification": "VERIFIED",
"credential_verification": "VERIFIED",
"certn_verification": "VERIFIED",
"employer_verification_results": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"certn_verification": "VERIFIED",
"company_name_verified": false,
"position_name_verified": false,
"income_verified": false,
"employment_dates_verified": true,
"verification_notes": "Verification notes!",
"employer": {
"company_name": "string",
"position": "string",
"income": 8500,
"pay_period": "PER_HOUR",
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string",
"employer_reference": {
"email": {
"address": "email@certn.co"
},
"phone_number": {
"phone_type": "NONE",
"number": "+1 250 555 1234",
"country": "string"
},
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
},
"contact": {
"can_contact": true,
"can_contact_after_date": "2021-11-12"
}
}
}
},
"education_verification_results": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"certn_verification": "VERIFIED",
"specializations_verified": false,
"degree_verified": false,
"institution_verified": false,
"enrolment_dates_verified": true,
"verification_notes": "Verification notes!",
"education": {
"institution": "string",
"degree": {
"degree": "2021-11-12",
"verified": true
},
"address": {
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2"
},
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string"
}
},
"credential_verification_results": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"certn_verification": "VERIFIED",
"certification_date_verified": false,
"certification_verified": false,
"institution_verified": true,
"verification_notes": "Verification notes!",
"credential": {
"description": "string",
"institution": "string",
"certification": "string",
"date_of_certification": "2021-11-12",
"current": true,
"certn_verification": "VERIFIED",
"verification_notes": "string"
}
}
},
"international_criminal_record_check_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"motor_vehicle_record_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"instant_verify_result": {
"instant_verify_employment": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"instant_verify_employment_result": [{
"verification_status": "VERIFIED",
"verifications_scale": 0.8,
"label_source_data": "Tiger Keeping",
"label_verifier_data": "Keeping of Tigers",
"org_source_data": "The Greater Wynnewood Exotic Animal Park",
"org_verifier_data": "The Greater Wynnewood Exotic Animal Park",
"dates_source_data": "Feb - Sept 2020",
"dates_verifier_data": "Feb - Sept 2020"
}
]
},
"instant_verify_education": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"instant_verify_education_result": [{
"verification_status": "VERIFIED",
"verifications_scale": 0.8,
"label_source_data": "Exploring Level 1",
"label_verifier_data": "Exploring 1",
"org_source_data": "DZ Center",
"org_verifier_data": "DZ Center",
"dates_source_data": "Feb - Sept 2020",
"dates_verifier_data": "Feb - Sept 2020"
}
]
},
"instant_verify_credential": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"instant_verification_credential_result": [{
"verification_status": "VERIFIED",
"verifications_scale": 0.8,
"label_source_data": "CPR",
"label_verifier_data": "CPR Care Giver",
"org_source_data": "Red Cross",
"org_verifier_data": "Red Cross",
"dates_source_data": "Feb - Sept 2020",
"dates_verifier_data": "Feb - Sept 2020"
}
]
}
},
"damage_to_property": 0,
"damage_to_property_label": "High",
"eviction_potential": 0,
"eviction_potential_label": "High",
"late_rent_potential": 0,
"late_rent_potential_label": "High",
"tenancy_length": 0,
"tenancy_length_label": "High"
}
]
}
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="404: Not Found Page not found" %}
This may be happening because:
**The page number you provided doesn't exist**
Make sure the page number you entered is a valid integer and within the bounds of your expected results.
*See* [#404-not-found](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#404-not-found "mention") *for more details.*
{% endtab %}
{% endtabs %}
## Retrieve an application
`GET` `https://api.certn.co/api/v2/applicants/{applicant_id}/`
View the details of an application.
Check the `status` field to see if the application is done processing.
You can retrieve the final report when the `report_status` field is marked as `COMPLETE`.
#### Path Parameters
| Name | Type | Description |
| ----------------------------------------------- | ------ | ------------------- |
| applicant\_id\* | string | ID of the applicant |
{% tabs %}
{% tab title="200: OK Report successfully retrieved" %}
{% tabs %}
{% tab title="Response type" %}
{% code title="application/json" %}
```json
{
"id": string ,
"created": string ,
"modified": string ,
"tag": string,
"(request_flags)": boolean
"last_updated": string ,
"submitted_time": string ,
"is_submitted": boolean,
"applicant_type": string ,
"report_status": string ,
"status": string ,
"status_label": string ,
"result": string ,
"result_label": string ,
"certn_score": number,
"certn_score_label": string ,
"applicant_account": {
"id": string,
"email": string
},
"application": {
object (Application)
},
"country": "CA",
"information": {
object (Information)
},
"employment_verification": string ,
"education_verification": string ,
"credential_verification": string ,
"reference_result": {
object (BasePackageResult)
},
"information_result": {
object (BasePackageResult)
},
"risk_result": {
object (RiskResult)
},
"equifax_result": {
object (EquifaxResult)
},
"identity_verified": boolean,
"employment_verified": boolean,
"identity_verification": {
object (Identity Verification)
},
"enhanced_identity_verification": {
object (EnhancedIdentityVerification)
},
"manual_id_verification": {
object (ManualIDVerification)
},
"rcmp_result": {
object (BasePackageResult)
},
"us_criminal_record_check_result": {
object (USCriminalRecordCheckResult)
},
"verification_result": {
object (VerificationResult)
},
"international_criminal_record_check_result": {
object (BasePackageResult)
},
"motor_vehicle_record_result": {
object (BasePackageResult)
},
"salary": number,
"sufficient_salary": boolean,
"high_risk_vulnerable_sector": boolean,
"job_safety_undue_risk": boolean,
"early_termination": number,
"early_termination_label": string ,
"reliability_risk": number,
"reliability_risk_label": string ,
"workplace_misconduct": number,
"workplace_misconduct_label": string
}
```
{% endcode %}
{% endtab %}
{% tab title="Example" %}
{% code title="application/json" %}
```json
{
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"tag": "Sub-Client 123",
"request_base": false,
"request_behavioural": false,
"request_softcheck": true,
"request_us_ssn_verification": false,
"request_equifax": true,
"request_identity_verification": false,
"request_enhanced_identity_verification": false,
"request_criminal_record_check": false,
"request_enhanced_criminal_record_check": false,
"request_us_criminal_record_check_tier_1": false,
"request_us_criminal_record_check_tier_2": false,
"request_us_criminal_record_check_tier_3": false,
"request_international_criminal_record_check": false,
"request_motor_vehicle_records": false,
"request_employment_verification": false,
"request_education_verification": false,
"request_credential_verification": false,
"request_employer_references": false,
"request_address_references": false,
"request_employer_phone_references": false,
"request_address_phone_references": false,
"request_instant_verify_employment": false,
"request_instant_verify_education": false,
"request_instant_verify_credential": false,
"last_updated": "2021-11-12T21:21:50Z",
"submitted_time": "2021-11-12T21:21:50Z",
"is_submitted": true,
"applicant_type": "STANDARD",
"report_status": "IN_PROGRESS",
"status": "Pending",
"status_label": "Pending",
"result": "REVIEW",
"result_label": "Review",
"certn_score": 85,
"certn_score_label": "PASS",
"applicant_account": {
"id": "string",
"email": "string"
},
"application": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"email": "string"
},
"country": "CA",
"information": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"first_name": "Sebastien",
"middle_name": "Jack Pierre",
"last_name": "Normandin",
"last_name_at_birth": "string",
"former_names": "string",
"alias": "string",
"date_of_birth": "2021-11-12",
"phone_number": "250-123-1234",
"sin_ssn": 123123123,
"gender": "M",
"birth_city": "string",
"birth_province_state": "string",
"birth_other_province_state": "string",
"birth_country": "string",
"license_number": "string",
"license_valid": true,
"license_prov_state": "string",
"license_other_country": true,
"license_type": "CA",
"cover_letter": "string",
"addresses": [
{
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2",
"rent_or_own": "R",
"cost": 0,
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string",
"address_reference": {
"email": {
"address": "email@certn.co"
},
"phone_number": {
"phone_type": "NONE",
"number": "+1 250 555 1234",
"country": "string"
},
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
},
"contact": {
"can_contact": true,
"can_contact_after_date": "2021-11-12"
}
}
}
],
"employers": [
{
"company_name": "string",
"position": "string",
"income": 8500,
"pay_period": "PER_HOUR",
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string",
"employer_reference": {
"email": {
"address": "email@certn.co"
},
"phone_number": {
"phone_type": "NONE",
"number": "+1 250 555 1234",
"country": "string"
},
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
},
"contact": {
"can_contact": true,
"can_contact_after_date": "2021-11-12"
}
}
}
],
"educations": [
{
"institution": "string",
"degree": {
"degree": "2021-11-12",
"verified": true
},
"address": {
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2"
},
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string"
}
],
"convictions": [
{
"offense": 2002,
"date_of_sentence": "2000-01-01T00:00:00.000Z",
"court_location": "Toronto, ON, Canada",
"description": "Robbery; Theft over $200"
}
]
},
"employment_verification": "VERIFIED",
"education_verification": "VERIFIED",
"credential_verification": "VERIFIED",
"reference_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"information_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"behavioural_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"risk_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"risk_evaluations": [
{
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"overall_score": "PASS",
"risk_information_result": {},
"criminal_results": [
{
"confidence": 0,
"confidence_label": "Likely",
"overall_score": "PASS",
"criminal_identity": {
"criminal_cases": [
{
"case_type": "Criminal",
"number": "123asd",
"file_date": "2000-12-12",
"judgment_date": "2000-12-12",
"summary_description": "The case filings summary description",
"full_description": "string",
"notes": "No additional case notes available",
"court": {
"court": "Seattle Superior Court",
"court_type": "Criminal",
"docket_number": "545fjd",
"filed_date": "2000-12-12",
"served_date": "2000-12-12",
"trial_date": "2000-12-12",
"jurisdiction": "Seattle County"
},
"criminal_charges": [
{
"offense_description": "Breach of peace",
"offense_date": "2000-12-12",
"offense_type": "Felony",
"plea": "Not Guilty",
"hearing_date": "2000-12-12",
"hearing_type": "Open court hearing",
"probation": "No probation given",
"community_service": "No community service given",
"sentence_suspended": "None",
"fines": "No fines given",
"fines_paid_status": "Fines not paid",
"fines_paid_date": "2000-12-12",
"cost": "200",
"restitution": "None",
"transferred_jurisdiction": "Transferred from Seattle",
"transferred_case_number": "690330",
"active_warrant": "No active warrant",
"jail_time": "6 months jail time",
"prison_time": "6 months prison time",
"charge_in_progress": "no charge in progress",
"charge": "Vehicular manslaughter two counts",
"charge_level": "Felony",
"charge_class": "None",
"dispositions": [
{
"offense_description": "Speeding",
"offense_type": "Infraction",
"offense_date": "2000-12-12",
"description": "Description of the disposition offense",
"disposition_date": "2000-12-12",
"statue": "20-1212(B)",
"offense_class": "The offense class description",
"final_plea": "Not Guilty",
"disposition_description": "The description of the dispostion"
}
],
"arrests": [
{
"arrest_date": "2000-12-12",
"booking_number": "42069",
"citation_number": "247365",
"arresting_agency": "KERSHAW COUNTY DETENTION CENTER",
"offense_type": "Misdemeanor",
"offense_description": "A description of the arresting offense",
"counts": "Arrest has 6 counts"
}
],
"sentences": [
{
"sentence_type": "Community Service and Fines",
"duration": "6 months",
"amount": "100",
"amount_paid": "50",
"paid": "Half the fine has been paid",
"qualifier": "The sentence has no qualifier information",
"description": "The sentence description",
"effective_date": "2000-12-12",
"appearance_date": "2000-12-12",
"appearance_finding": "There are no appearance findings to detail about the sentence"
}
],
"additional_informations": [
{
"description": "More case information was found.",
"additional_description": "None",
"event_date": "2000-12-12"
}
]
}
]
}
],
"criminal_alerts": [
{
"parent_category": "FRAUD",
"category": "Burglary",
"stage": "Conviction",
"type": "Citation",
"description": "Convicted of burglary",
"date": "2000-12-12",
"parent_category_label": "Fraud"
}
],
"criminal_sources": [
{
"name": "World News",
"url": "worldnews.com",
"date": "2000-12-12",
"format": "Online Media",
"headline": "Burglary Conviction for Area Man",
"publication_source": "World News Conglomerate",
"publisher": "World News"
}
],
"criminal_addresses": [
{
"start_date": "2000-12-12",
"end_date": "2000-12-12",
"unit": "1a",
"address": "123 fort st.",
"city": "Victoria",
"province_state": "BC",
"country": "Canda",
"postal_code": "V8X2C3"
}
],
"criminal_additional_informations": [
{
"aliases": [
"willy will",
"billy bill"
],
"dates_of_birth": [
"2000-12-12"
],
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
}
}
]
}
}
]
}
]
},
"equifax_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"description": "The financial score is based on self-provided information from the applicant and an analysis of the applicant's information available to Certn. This includes a credit check, Equifax record analysis, as well as other important informational data points",
"total_debt": 100,
"upgradable": false,
"trades": [
{
"credit_grantor": "RBC",
"payment_status": "Up to date",
"date_opened": "2000-12-12",
"account_rating": "High",
"date_reported": "2000-12-12",
"account_type": "Revolving",
"high_credit": 2000,
"balance_amount": 1000,
"last_activity_or_payment": "Paid as up to date",
"r_code": "R-1",
"percent_credit_used": 50,
"account_number": "112ksjd",
"past_due_amount": 0,
"payment_term_amount": 120,
"months_reviewed": 15,
"narratives": [
"Account has been paid in full."
]
}
],
"employers": [
{
"employment": "Subject's Current Employer",
"occupation": "Software",
"employer": "Certn",
"city": "Victoria",
"province": "BC",
"verification": true,
"salary": 1000000
}
],
"addresses": [
{
"address": "123 fort st.",
"civic_number": 123,
"street_name": "fort st.",
"city": "Victoria",
"province": "BC"
}
],
"collections": [
{
"date_of_last_payment": "2000-12-12",
"creditor": "Boys Club",
"amount_owed": 10000,
"amount_paid": 50,
"ledger_number": "123aslld",
"date_paid": "2000-12-12T00:00:00.000Z",
"date_reported": "2000-12-12T00:00:00.000Z",
"assigned_date": "2012-12-12T00:00:00.000Z",
"verification_date": "2000-12-12T00:00:00.000Z",
"account_designation": "Individual",
"first_deliquency": "2000-12-12T00:00:00.000Z",
"agency_entity": "GQC123",
"reason": "Credit not paid on in full",
"description": "Parking ticket"
}
],
"deposit_alerts": [
{
"customer_entity": "RBC",
"date_reported": "2000-12-12T00:00:00.000Z",
"account_type": "Business",
"date_opened": "2000-12-12T00:00:00.000Z",
"date_closed": "2000-12-12T00:00:00.000Z",
"date_written_off": "2000-12-12T00:00:00.000Z",
"amount_written_off": 2000,
"alert_status": "High",
"alert_status_date": "2000-12-12T00:00:00.000Z"
}
],
"bankruptcies": [
{
"account_type": "Individual",
"liability_amount": 2000,
"asset_amount": 20000,
"customer": "CRED COUNSELLING SOC",
"case_number_and_trustee": "12312 CE ASSOCIATES",
"filer": "Subject",
"legal_narrative": "No legal information available",
"date_filed": "2000-12-12T00:00:00.000Z",
"intent_or_disposition": "Discharged"
}
],
"judgments": [
{
"plaintiff": "Fred Rickleson",
"defendant": "Rick Frederickson",
"amount": 1000.21,
"date_filed": "2000-12-12T00:00:00.000Z",
"date_satisfied": "2000-12-12T00:00:00.000Z",
"verification_date": "2000-12-12T00:00:00.000Z",
"court_entity": "RBC",
"garnishee": "RBC",
"description": "Fred sued Rick"
}
],
"legal_items": [
{
"case_number": "1232djdsj",
"verification_date": "2000-12-12T00:00:00.000Z",
"update_source_code": "Tape rptd",
"date_filed": "2000-12-12T00:00:00.000Z",
"court_entity": "Toronto small claims",
"status_code": "Satisfied",
"date_satisfied": "2000-12-12T00:00:00.000Z",
"amount": 10000,
"defendant": "John Smithy",
"plaintiff": "Smith Johny",
"lawyer_name_address": "Johnson LLC 123 fort st Victoria",
"legal_item_description": "It was very bad deal"
}
],
"liens": [
{
"amount": 1000,
"date_filed": "1999-12-12T00:00:00.000Z",
"lien_class": "Class A",
"date_released": "1990-12-12T00:00:00.000Z",
"date_verified": "1990-12-12T00:00:00.000Z",
"court_entity": "Superior Court.",
"case_number": "123asda",
"lien_description": "Lien on house."
}
],
"secured_loans": [
{
"date_filed": "1990-12-12T00:00:00.000Z",
"court_entity": "Superior",
"creditor_name_address": "RBC 123 Main st.",
"creditor_industry_code": "620a",
"maturity_date": "1990-12-12T00:00:00.000Z"
}
],
"fraud_warnings": [
{
"product_description": "Fraud warnings are warnings of fraud.",
"message_priority": "Very high",
"message_code": "123a",
"message_description": "High fraud alert for bank fraud"
}
],
"non_sufficient_funds": [
{
"date_reported": "1990-12-12T00:00:00.000Z",
"creditor_entity": "RBC",
"nsfamount": 1000.2,
"details": "No sufficient funds in savings account.",
"verification_date": "1990-12-12T00:00:00.000Z"
}
],
"credit_file_metadatas": [
{
"hit_strength_indicator": "HIT",
"request_number": "123asd",
"address_discrepancy": "No discrepancy found in address",
"customer_number": "123asd",
"report_id": "123asd",
"file_since_date": "1990-12-12T00:00:00.000Z",
"date_of_last_activity": "1990-12-12T00:00:00.000Z",
"date_of_request": "1990-12-12T00:00:00.000Z",
"hit": "Big Hit",
"data_warning_messages": [
"No data warning messages"
],
"card_alert_warning_messages": [
"Credit card on high alert"
],
"alert_indicators": [
"No messages"
]
}
],
"other_incomes": [
{
"date_reported": "1990-12-12T00:00:00.000Z",
"income_source": "RBC",
"amount": 1000000,
"verification_date": "1990-12-12T00:00:00.000Z"
}
],
"consumer_statements": [
{
"date_reported": "1990-12-12T00:00:00.000Z",
"statement": "No consumer statement available."
}
],
"bank_accounts": [
{
"account": "Personal checking",
"date_reported": "1990-12-12T00:00:00.000Z",
"creditor_entity": "RBC",
"account_number": "123asd",
"figure_amount": 1000.12,
"date_opened": "1990-12-12T00:00:00.000Z",
"account_type": "Checking",
"status": "active",
"number_of_nsf": 0
}
],
"local_inquiries": [
{
"inquiry_date": "1990-12-12T00:00:00.000Z",
"customer_name": "Certn"
}
],
"foreign_inquiries": [
{
"inquiry_date": "1990-12-12T00:00:00.000Z",
"city_name_or_inquiry_number": "Seattle",
"inquiry_province": "WA"
}
]
},
"identity_verified": true,
"employment_verified": true,
"identity_verification": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"status": "A",
"result": "VERIFIED"
},
"enhanced_identity_verification": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"status": "A",
"result": "VERIFIED"
},
"manual_id_verification": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"created": "2021-11-12T21:21:50Z",
"modified": "2021-11-12T21:21:50Z",
"status": "A",
"result": "VERIFIED"
},
"rcmp_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"us_criminal_record_check_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"criminal_cases": [
{
"case_type": "Criminal",
"number": "123asd",
"file_date": "2000-12-12",
"judgment_date": "2000-12-12",
"summary_description": "The case filings summary description",
"full_description": "string",
"notes": "No additional case notes available",
"court": {
"court": "Seattle Superior Court",
"court_type": "Criminal",
"docket_number": "545fjd",
"filed_date": "2000-12-12",
"served_date": "2000-12-12",
"trial_date": "2000-12-12",
"jurisdiction": "Seattle County"
},
"criminal_charges": [
{
"offense_description": "Breach of peace",
"offense_date": "2000-12-12",
"offense_type": "Felony",
"plea": "Not Guilty",
"hearing_date": "2000-12-12",
"hearing_type": "Open court hearing",
"probation": "No probation given",
"community_service": "No community service given",
"sentence_suspended": "None",
"fines": "No fines given",
"fines_paid_status": "Fines not paid",
"fines_paid_date": "2000-12-12",
"cost": "200",
"restitution": "None",
"transferred_jurisdiction": "Transferred from Seattle",
"transferred_case_number": "690330",
"active_warrant": "No active warrant",
"jail_time": "6 months jail time",
"prison_time": "6 months prison time",
"charge_in_progress": "no charge in progress",
"charge": "Vehicular manslaughter two counts",
"charge_level": "Felony",
"charge_class": "None",
"dispositions": [
{
"offense_description": "Speeding",
"offense_type": "Infraction",
"offense_date": "2000-12-12",
"description": "Description of the disposition offense",
"disposition_date": "2000-12-12",
"statue": "20-1212(B)",
"offense_class": "The offense class description",
"final_plea": "Not Guilty",
"disposition_description": "The description of the dispostion"
}
],
"arrests": [
{
"arrest_date": "2000-12-12",
"booking_number": "42069",
"citation_number": "247365",
"arresting_agency": "KERSHAW COUNTY DETENTION CENTER",
"offense_type": "Misdemeanor",
"offense_description": "A description of the arresting offense",
"counts": "Arrest has 6 counts"
}
],
"sentences": [
{
"sentence_type": "Community Service and Fines",
"duration": "6 months",
"amount": "100",
"amount_paid": "50",
"paid": "Half the fine has been paid",
"qualifier": "The sentence has no qualifier information",
"description": "The sentence description",
"effective_date": "2000-12-12",
"appearance_date": "2000-12-12",
"appearance_finding": "There are no appearance findings to detail about the sentence"
}
],
"additional_informations": [
{
"description": "More case information was found.",
"additional_description": "None",
"event_date": "2000-12-12"
}
]
}
]
}
],
"ssn_id_document_reports": [
{
"ssn_result": "Discrepancy",
"ssn_status": "Complete",
"names": [
{
"first_name": "string",
"middle_name": "string",
"last_name": "string"
}
],
"addresses": [
{
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2"
}
],
"id_documents": [
{
"type": "Passport",
"number": "123412kdsdsk",
"issuing_country": "US",
"issuing_province_state": "WA",
"issue_date": "2000-12-12",
"expiry_date": "2000-12-12"
}
],
"dates_of_birth": [
{
"date_of_birth": "2000-12-12"
}
]
}
],
"scan_status": {
"national_sex_offender_registry_scan": "Complete",
"security_watch_list_scan": "Complete",
"fraud_scan": "Complete",
"ofac_global_sanctions_scan": "Complete",
"ssn_verification_scan": "Complete",
"criminal_record_scan": "Complete",
"federal_record_scan": "Incomplete",
"single_state_county_record_scan": "Incomplete",
"all_state_county_record_scan": "Incomplete"
},
"record_check_requests": [
{
"status": "Complete",
"state": "OH",
"county": "Kershaw",
"district": "District 1",
"fips_code": 12312,
"search_type": "Criminal/Court Database Search"
}
]
},
"verification_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"employment_verification": "VERIFIED",
"education_verification": "VERIFIED",
"credential_verification": "VERIFIED",
"certn_verification": "VERIFIED",
"employer_verification_results": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"certn_verification": "VERIFIED",
"company_name_verified": false,
"position_name_verified": false,
"income_verified": false,
"employment_dates_verified": true,
"verification_notes": "Verification notes!",
"employer": {
"company_name": "string",
"position": "string",
"income": 8500,
"pay_period": "PER_HOUR",
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string",
"employer_reference": {
"email": {
"address": "email@certn.co"
},
"phone_number": {
"phone_type": "NONE",
"number": "+1 250 555 1234",
"country": "string"
},
"name": {
"first_name": "string",
"middle_name": "string",
"last_name": "string"
},
"contact": {
"can_contact": true,
"can_contact_after_date": "2021-11-12"
}
}
}
},
"education_verification_results": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"certn_verification": "VERIFIED",
"specializations_verified": false,
"degree_verified": false,
"institution_verified": false,
"enrolment_dates_verified": true,
"verification_notes": "Verification notes!",
"education": {
"institution": "string",
"degree": {
"degree": "2021-11-12",
"verified": true
},
"address": {
"address": "4412 King Alfred Court",
"unit": 100,
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8A1B2"
},
"start_date": "2021-11-12",
"end_date": "2021-11-12",
"certn_verification": "VERIFIED",
"verification_notes": "string"
}
},
"credential_verification_results": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"certn_verification": "VERIFIED",
"certification_date_verified": false,
"certification_verified": false,
"institution_verified": true,
"verification_notes": "Verification notes!",
"credential": {
"description": "string",
"institution": "string",
"certification": "string",
"date_of_certification": "2021-11-12",
"current": true,
"certn_verification": "VERIFIED",
"verification_notes": "string"
}
}
},
"international_criminal_record_check_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"motor_vehicle_record_result": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review"
},
"instant_verify_result": {
"instant_verify_employment": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"instant_verify_employment_result": [
{
"verification_status": "VERIFIED",
"verifications_scale": 0.8,
"label_source_data": "Tiger Keeping",
"label_verifier_data": "Keeping of Tigers",
"org_source_data": "The Greater Wynnewood Exotic Animal Park",
"org_verifier_data": "The Greater Wynnewood Exotic Animal Park",
"dates_source_data": "Feb - Sept 2020",
"dates_verifier_data": "Feb - Sept 2020"
}
]
},
"instant_verify_education": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"instant_verify_education_result": [
{
"verification_status": "VERIFIED",
"verifications_scale": 0.8,
"label_source_data": "Exploring Level 1",
"label_verifier_data": "Exploring 1",
"org_source_data": "DZ Center",
"org_verifier_data": "DZ Center",
"dates_source_data": "Feb - Sept 2020",
"dates_verifier_data": "Feb - Sept 2020"
}
]
},
"instant_verify_credential": {
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "ANALYZING",
"status_label": "Analyzing",
"overall_score": "PASS",
"overall_score_label": "Pass",
"red_flags": [
"This may indicate the applicant is high risk."
],
"green_flags": [
"This may indicate the applicant is low risk."
],
"result": "REVIEW",
"result_label": "Review",
"instant_verification_credential_result": [
{
"verification_status": "VERIFIED",
"verifications_scale": 0.8,
"label_source_data": "CPR",
"label_verifier_data": "CPR Care Giver",
"org_source_data": "Red Cross",
"org_verifier_data": "Red Cross",
"dates_source_data": "Feb - Sept 2020",
"dates_verifier_data": "Feb - Sept 2020"
}
]
}
},
"damage_to_property": 0,
"damage_to_property_label": "High",
"eviction_potential": 0,
"eviction_potential_label": "High",
"late_rent_potential": 0,
"late_rent_potential_label": "High",
"tenancy_length": 0,
"tenancy_length_label": "High"
}
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="404: Not Found Application not found" %}
This may be happening because:
**The ID you provided couldn't be found**
Add your [application ID](https://docs.certn.co/api/certn-api-v-1.0/getting-started/demo-account/retrieve-results#send-the-request) to the URL and make sure it's in the proper format.
*See* [#404-not-found](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#404-not-found "mention") *for more details.*
{% endtab %}
{% endtabs %}
## Reports
A report shows the final results of the requested checks. These endpoints allow you to retrieve your reports in the format of your choice.
## Download a PDF report
`GET` `https://api.certn.co/api/v2/reports/{applicant_id}/pdf`
Download an application's report as a PDF file.
To download the report, wait for the application's `status` field to show `Returned`.
#### Path Parameters
| Name | Type | Description |
| ----------------------------------------------- | ------ | ------------------- |
| applicant\_id\* | string | ID of the applicant |
{% tabs %}
{% tab title="200: OK Report as a PDF file" %}
{% tabs %}
{% tab title="Response type" %}
{% code title="application/pdf" %}
```
string
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="400: Bad Request Incomplete application" %}
This may be happening because:
**The application is still processing**
Wait for the application's `status` field to show `Returned` before generating the final report.
*See* [#400-bad-request](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#400-bad-request "mention") *for more details.*
{% endtab %}
{% tab title="404: Not Found Application not found" %}
This may be happening because:
**The ID you provided couldn't be found**
Add your [application ID](https://docs.certn.co/api/certn-api-v-1.0/getting-started/demo-account/retrieve-results#send-the-request) to the URL and make sure it's in the proper format.
*See* [#404-not-found](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#404-not-found "mention") *for more details.*
{% endtab %}
{% endtabs %}
## Create a hosted PDF report
`GET` `https://api.certn.co/api/v2/reports/{applicant_id}/link`
Create a PDF report hosted on Certn's servers. The URL returned can be used to view the report without downloading it. *This link is valid for 1 hour only.*
To create the hosted PDF report, wait for the application's `status` field to show `Returned`.
#### Path Parameters
| Name | Type | Description |
| ----------------------------------------------- | ------ | ------------------- |
| applicant\_id\* | string | ID of the applicant |
{% tabs %}
{% tab title="200: OK URL to view the report" %}
{% tabs %}
{% tab title="Response type" %}
```
{
"report_url": string
}
```
{% endtab %}
{% tab title="Example" %}
```
{
"report_url": "https://s3.ca-central-1.amazonaws.com/certn-reports/pm_806066d2-f9e7-4d54-844e-bcc225a8ef6d_1575603960.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAI322I2RK3VQJ4O3Q%2F20191206%2Fca-central-1%2Fs3%2Faws4_request&X-Amz-Date=20191206T034608Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=0032b9ff42a2fe1135d28079f67b70338f5abc373b4b0a72707e3109eac8815d"
}
```
{% endtab %}
{% endtabs %}
```javascript
{
// Response
}
```
{% endtab %}
{% tab title="400: Bad Request Incomplete application" %}
This may be happening because:
**The application is still processing**
Wait for the application's `status` field to show `Returned` before generating the final report.
*See* [#400-bad-request](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#400-bad-request "mention") *for more details.*
{% endtab %}
{% tab title="404: Not Found Application not found" %}
This may be happening because:
**The ID you provided couldn't be found**
Add your [application ID](https://docs.certn.co/api/certn-api-v-1.0/getting-started/demo-account/retrieve-results#send-the-request) to the URL and make sure it's in the proper format.
*See* [#404-not-found](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#404-not-found "mention") *for more details.*
{% endtab %}
{% endtabs %}
## Download an HTML report
`GET` `https://api.certn.co/api/v2/reports/{applicant_id}/web/`
Download an application's report as an HTML file.
To download the report, wait for the application's `status` field to show `Returned`.
#### Path Parameters
| Name | Type | Description |
| ----------------------------------------------- | ------ | ------------------- |
| applicant\_id\* | string | ID of the applicant |
{% tabs %}
{% tab title="200: OK The report as an HTML file" %}
{% tabs %}
{% tab title="Response type" %}
{% code title="application/json" %}
```
{
"html": string
}
```
{% endcode %}
{% endtab %}
{% tab title="Example" %}
{% code title="application/json" %}
```json
{
"html": "\\n\\n\\nCertn ReportPM"
}
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="400: Bad Request Incomplete application" %}
This may be happening because:
**The application is still processing**
Wait for the application's `status` field to show `Returned` before generating the final report.
*See* [#400-bad-request](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#400-bad-request "mention") *for more details.*
{% endtab %}
{% tab title="404: Not Found Application not found" %}
This may be happening because:
**The ID you provided couldn't be found**
Add your [application ID](https://docs.certn.co/api/certn-api-v-1.0/getting-started/demo-account/retrieve-results#send-the-request) to the URL and make sure it's in the proper format.
*See* [#404-not-found](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#404-not-found "mention") *for more details.*
{% endtab %}
{% endtabs %}
## Properties
A property is a specific location with an address that you are renting. These endpoints allow you to create and retrieve the properties associated with your team.
## Retrieve your properties
`GET` `https://api.certn.co/api/v2/properties/`
View the details of all your properties.
The results are sent via paginated response. To retrieve the next page, send a request to the URL under the field `next`, or add one to your page counter:
`https://api.certn.co/api/v2/properties/?page=`
#### Query Parameters
| Name | Type | Description |
| ---- | ---- | ----------------------- |
| page | int | Page number to retrieve |
{% tabs %}
{% tab title="200: OK Properties successfully retrieved" %}
{% tabs %}
{% tab title="Response type" %}
```
[
{
"building": string,
"building_code": string,
"address": string,
"city": string,
"county": string,
"province_state": string ,
"country": string ,
"is_active": boolean,
"owner_id": string
}
]
```
{% endtab %}
{% tab title="Example" %}
{% code title="application/json" %}
```json
[
{
"building": "View Towers",
"building_code": "123ABC",
"address": "1017 Fort Street",
"city": "Victoria",
"county": null,
"province_state": "string",
"country": "string",
"is_active": true,
"owner_id": "string"
}
]
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="404: Not Found Page not found" %}
This may be happening because:
**The page number you provided doesn't exist**
Make sure the page number you entered is a valid integer and within the bounds of your expected results.
*See* [#404-not-found](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#404-not-found "mention") *for more details.*
{% endtab %}
{% endtabs %}
## Create a property
`POST` `https://api.certn.co/api/v2/properties`
Create a new property with the information provided in the body of your request.
#### Request Body
| Name | Type | Description |
| ------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------- |
| building | string | Building's name |
| building\_code | string | |
| address\* | string | |
| city\* | string | |
| province\_state\* | string | [ISO Code](https://docs.certn.co/api/certn-api-v-1.0/resources/region-codes#provinces-and-states) |
| country | string | [ISO Country Code](https://docs.certn.co/api/certn-api-v-1.0/resources/region-codes#countries) |
| is\_active | boolean | |
| owner\_id\* | string | Assign this property to a specific user |
| county\* | string | USA county, required for USA addresses |
{% tabs %}
{% tab title="201: Created Property successfully created" %}
{% tabs %}
{% tab title="Response type" %}
{% code title="application/json" %}
```json
{
"id": string ,
"status": string,
"get_status_display": string,
"created": string ,
"modified": string ,
"last_updated": string ,
"building": string,
"building_code": string,
"address": string,
"city": string,
"county": string,
"province_state": string ,
"country": string ,
"postal_code": string,
"is_active": boolean,
"owner": {
"id": string ,
"email": string,
"team": {
"id": string ,
"name": string,
"country": string ,
"industry": string,
"team_type": string,
"internal_name": string,
"app_url": string,
"compliance_region": {
"id": string ,
"name": string,
"country": string ,
"team_type": string,
"sub_region": string,
"default": boolean,
"score_value_field": string,
"score_label_field": string,
"show_legal_us": boolean,
"show_credit_report": boolean,
"show_fcra": boolean,
"require_address_history": boolean
},
"settings_config": {
"get_org_name": string,
"org_name": string,
"org_logo_link": string,
"org_primary_color": string,
"whitelabel_report": boolean,
"whitelabel_emails": boolean,
"compact_pdf_report": boolean,
"behavioural_test_req": boolean,
"emergency_contact_req": boolean,
"personal_ref_req": boolean,
"education_req": boolean,
"tenancy_years_amount_req": int,
"tenancy_ref_amount_req": int,
"tenancy_ref_email_req": boolean,
"tenancy_ref_phone_req": boolean,
"employer_years_amount_req": int,
"employer_ref_req": boolean,
"employer_ref_email_req": boolean,
"employer_ref_phone_req": boolean,
"document_required": boolean,
"cover_letter_req": boolean,
"government_id_req": boolean,
"proof_of_income_req": boolean,
"resume_req": boolean,
"visa_req": boolean,
"personal_ref_amount_req": int,
"passport_req": boolean,
"hide_detailed_financial": boolean,
"hide_sin_ssn": boolean,
"hide_date_of_birth": boolean,
"enable_rcmp_reflow": boolean,
"hide_id_verification_photos": boolean,
"hide_current_address": boolean,
"require_id_with_address": boolean,
"hide_activity_log": boolean,
"redirect_url": string,
"custom_tracks": [],
"my_crc_region": string,
"hide_ssn_trace": boolean,
"request_base": boolean,
"request_behavioural": boolean,
"request_softcheck": boolean,
"request_equifax": boolean,
"request_identity_verification": boolean,
"request_enhanced_identity_verification": boolean,
"request_criminal_record_check": boolean,
"request_enhanced_criminal_record_check": boolean,
"request_vulnerable_sector_criminal_record_check": boolean,
"request_motor_vehicle_records": boolean,
"request_education_verification": boolean,
"request_employment_verification": boolean,
"request_us_criminal_softcheck": boolean,
"request_us_ssn_verification": boolean,
"request_employer_references": boolean,
"request_address_references": boolean,
"request_employer_phone_references": boolean,
"request_address_phone_references": boolean,
"request_international_criminal_record_check": boolean,
"request_soquij": boolean,
"request_instant_verify_employment": boolean,
"request_instant_verify_education": boolean,
"request_instant_verify_credential": boolean,
"employer_references_min": int,
"employer_references_max": int,
"address_references_min": int,
"address_references_max": int,
"employment_verification_min": int,
"employment_verification_max": int,
"education_verification_min": int,
"education_verification_max": int,
"credential_verification_min": int,
"credential_verification_max": int,
"credential_verification_level": string,
"education_verification_level": string,
"employer_references_years": int,
"address_references_years": int,
"employment_verification_years": int,
"employment_verification_years_or_individually": string,
"address_references_years_or_individually": string,
"employer_references_years_or_individually": string,
"us_criminal_record_check_years": int,
"applicant_login": boolean,
"exclude_softcheck_possible_matches": boolean,
"workable_fast_complete": boolean,
"review_all_negative_mvr_results": boolean,
"limit_education_verifications": boolean
},
"billing_plan": {
},
"google_analytics_key": string,
"adwords_key": string,
"adwords_conversion_key": string,
"external_domain": string
}
},
"listing_count": int,
"full_address": string,
"url_code": string
}
```
{% endcode %}
{% endtab %}
{% tab title="Example" %}
{% code title="application/json" %}
```json
{
"id": "a123b4cd-1a23-1a23-12a3-a123456b7890",
"status": "N",
"get_status_display": "No Vacancy",
"created": "2022-01-20T23:14:13.817172Z",
"modified": "2022-01-20T23:14:13.817198Z",
"last_updated": "2022-01-20T23:14:13.817227Z",
"building": "View Towers",
"building_code": "123ABC",
"address": "1017 Fort Street",
"city": "Victoria",
"county": null,
"province_state": "BC",
"country": "CA",
"postal_code": null,
"is_active": true,
"owner": {
"id": "d4129823-0ccd-4fa3-99b2-c30baaa01c89",
"email": "email@certn.co",
"team": {
"id": "9f887774-d577-4d2f-b109-82951065993b",
"name": "Team",
"country": "CA",
"industry": "",
"team_type": "PM",
"internal_name": "Team",
"app_url": "https://api.certn.co/",
"compliance_region": {
"id": "eac92691-2ba5-46c6-8e76-1ca85db2a142",
"name": "Initial",
"country": "CA",
"team_type": "PM",
"sub_region": "",
"default": true,
"score_value_field": "certn_score",
"score_label_field": "report_summary.report_result_label",
"show_legal_us": false,
"show_credit_report": true,
"show_fcra": false,
"require_address_history": true
},
"settings_config": {
"get_org_name": "Team",
"org_name": "Team",
"org_logo_link": "https://certn-images.s3.amazonaws.com/yourlogo_here_copy.png",
"org_primary_color": "#35c9b3",
"whitelabel_report": false,
"whitelabel_emails": false,
"compact_pdf_report": false,
"behavioural_test_req": false,
"emergency_contact_req": false,
"personal_ref_req": false,
"education_req": false,
"tenancy_years_amount_req": 4,
"tenancy_ref_amount_req": 1,
"tenancy_ref_email_req": false,
"tenancy_ref_phone_req": false,
"employer_years_amount_req": 0,
"employer_ref_req": false,
"employer_ref_email_req": false,
"employer_ref_phone_req": false,
"document_required": false,
"cover_letter_req": false,
"government_id_req": false,
"proof_of_income_req": false,
"resume_req": false,
"visa_req": false,
"personal_ref_amount_req": 0,
"passport_req": false,
"hide_detailed_financial": false,
"hide_sin_ssn": true,
"hide_date_of_birth": false,
"enable_rcmp_reflow": false,
"hide_id_verification_photos": false,
"hide_current_address": true,
"require_id_with_address": false,
"hide_activity_log": true,
"redirect_url": null,
"custom_tracks": [],
"my_crc_region": null,
"hide_ssn_trace": true,
"request_base": true,
"request_behavioural": true,
"request_softcheck": true,
"request_equifax": false,
"request_identity_verification": false,
"request_enhanced_identity_verification": false,
"request_criminal_record_check": false,
"request_enhanced_criminal_record_check": false,
"request_vulnerable_sector_criminal_record_check": false,
"request_motor_vehicle_records": false,
"request_education_verification": false,
"request_employment_verification": false,
"request_us_criminal_softcheck": false,
"request_us_ssn_verification": false,
"request_employer_references": false,
"request_address_references": true,
"request_employer_phone_references": false,
"request_address_phone_references": false,
"request_international_criminal_record_check": false,
"request_soquij": false,
"request_instant_verify_employment": false,
"request_instant_verify_education": false,
"request_instant_verify_credential": false,
"employer_references_min": 3,
"employer_references_max": 3,
"address_references_min": 2,
"address_references_max": 2,
"employment_verification_min": 3,
"employment_verification_max": 3,
"education_verification_min": 1,
"education_verification_max": 1,
"credential_verification_min": 1,
"credential_verification_max": 1,
"credential_verification_level": "ALL",
"education_verification_level": "ALL",
"employer_references_years": 5,
"address_references_years": 3,
"employment_verification_years": 5,
"employment_verification_years_or_individually": "INDIVIDUALLY",
"address_references_years_or_individually": "INDIVIDUALLY",
"employer_references_years_or_individually": "INDIVIDUALLY",
"us_criminal_record_check_years": 7,
"applicant_login": false,
"exclude_softcheck_possible_matches": false,
"workable_fast_complete": false,
"review_all_negative_mvr_results": false,
"limit_education_verifications": false
},
"billing_plan": {
},
"google_analytics_key": "",
"adwords_key": "",
"adwords_conversion_key": "",
"external_domain": ""
}
},
"listing_count": 0,
"full_address": "1017 Fort Street Victoria BC CA",
"url_code": ""
}
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="400: Bad Request Missing field, wrong data type" %}
This may be happening because:
**You are missing required fields**
Add all the required fields to the body of your request.
**You used the wrong format or data type for a field**
Format all your fields according to their [data type](https://www.w3schools.com/js/js_json_datatypes.asp).
*See* [#400-bad-request](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#400-bad-request "mention") *for more details.*
{% endtab %}
{% endtabs %}
## Listings
A listing is a specific unit that you have placed up for rent. These endpoints allow you to create and retrieve the listings associated with your team.
## Retrieve your listings
`GET` `https://api.certn.co/api/v2/listings/`
View the details of all your listings.
The results are sent via paginated response, in chronological order. To retrieve the next page, send a request to the URL under the field `next`, or add one to your page counter:
`https://api.certn.co/api/v2/listings/?page=`
#### Query Parameters
| Name | Type | Description |
| ---- | ---- | ----------------------- |
| page | int | Page number to retrieve |
{% tabs %}
{% tab title="200: OK Listings successfully retrieved" %}
{% tabs %}
{% tab title="Response type" %}
{% code title="application/json" %}
```json
[
{
"name": string,
"unit": string,
"move_in_date": string ,
"move_in_immediately": boolean,
"rent": number,
"security_deposit_amount": number,
"pet_deposit": boolean,
"pet_deposit_amount": number,
"storage_locker": boolean,
"property_manager_terms": string,
"is_active": boolean,
"is_public": boolean,
"url-code": string,
"property_id": string ,
"owner_id": string ,
"notification_list_ids": [
string
]
}
]
```
{% endcode %}
{% endtab %}
{% tab title="Example" %}
{% code title="application/json" %}
```json
[
{
"name": "string",
"unit": "string",
"move_in_date": "string",
"move_in_immediately": true,
"rent": 0,
"security_deposit_amount": 0,
"pet_deposit": true,
"pet_deposit_amount": 0,
"storage_locker": true,
"property_manager_terms": "string",
"is_active": true,
"is_public": true,
"url-code": "string",
"property_id": "string",
"owner_id": "string",
"notification_list_ids": [
"string"
]
}
]
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="404: Not Found Page not found" %}
This may be happening because:
**The page number you provided doesn't exist**
Make sure the page number you entered is a valid integer and within the bounds of your expected results.
*See* [#404-not-found](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#404-not-found "mention") *for more details.*
{% endtab %}
{% endtabs %}
## Create a listing
`POST` `https://api.certn.co/api/v2/listings/`
Create a new listing with the information provided in the body of your request.
#### Request Body
| Name | Type | Description |
| --------------------------------------------------------- | ------------------------ | ------------------------- |
| name | string | Listing manager's name |
| pet\_deposit | boolean | |
| security\_deposit\_amount | number | |
| rent\* | number | |
| move\_in\_immediately | boolean | |
| move\_in\_date | string | Move in date `YYYY-MM-DD` |
| unit | string | |
| pet\_deposit\_amount | number | |
| url-code | string | |
| is\_active | boolean | |
| property\_manager\_terms | string | |
| storage\_locker | boolean | |
| notification\_list\_ids\* | Array of strings \ | |
| owner\_id\* | string \ | |
| property\_id\* | string \ | |
{% tabs %}
{% tab title="201: Created Listing successfully created" %}
{% tabs %}
{% tab title="Response type" %}
{% code title="application/json" %}
```json
{
"id": string ,
"created": string ,
"modified": string ,
"last_updated": string ,
"name": string,
"unit": string,
"move_in_date": string ,
"move_in_immediately": boolean,
"rent": string,
"rent_range": string,
"security_deposit_amount": string,
"pet_deposit": boolean,
"pet_deposit_amount": string,
"storage_locker": boolean,
"property_manager_terms": string,
"is_active": boolean,
"is_public": boolean,
"url_code": string,
"is_placeholder": boolean,
"owner": {
"id": string ,
"email": string,
"team": {
"id": string ,
"name": string,
"country": string,
"industry": string,
"team_type": string,
"internal_name": string,
"app_url": string,
"compliance_region": {
"id": string ,
"name": string,
"country": string ,
"team_type": string,
"sub_region": string,
"default": boolean,
"score_value_field": string,
"score_label_field": string,
"show_legal_us": boolean,
"show_credit_report": boolean,
"show_fcra": boolean,
"require_address_history": boolean
},
"settings_config": {
"get_org_name": string,
"org_name": string,
"org_logo_link": string,
"org_primary_color": string,
"whitelabel_report": boolean,
"whitelabel_emails": boolean,
"compact_pdf_report": boolean,
"behavioural_test_req": boolean,
"emergency_contact_req": boolean,
"personal_ref_req": boolean,
"education_req": boolean,
"tenancy_years_amount_req": int,
"tenancy_ref_amount_req": int,
"tenancy_ref_email_req": boolean,
"tenancy_ref_phone_req": boolean,
"employer_years_amount_req": int,
"employer_ref_req": boolean,
"employer_ref_email_req": boolean,
"employer_ref_phone_req": boolean,
"document_required": boolean,
"cover_letter_req": boolean,
"government_id_req": boolean,
"proof_of_income_req": boolean,
"resume_req": boolean,
"visa_req": boolean,
"personal_ref_amount_req": int,
"passport_req": boolean,
"hide_detailed_financial": boolean,
"hide_sin_ssn": boolean,
"hide_date_of_birth": boolean,
"enable_rcmp_reflow": boolean,
"hide_id_verification_photos": boolean,
"hide_current_address": boolean,
"require_id_with_address": boolean,
"hide_activity_log": boolean,
"redirect_url": string,
"custom_tracks": [],
"my_crc_region": string,
"hide_ssn_trace": boolean,
"request_base": boolean,
"request_behavioural": boolean,
"request_softcheck": boolean,
"request_equifax": boolean,
"request_identity_verification": boolean,
"request_enhanced_identity_verification": boolean,
"request_criminal_record_check": boolean,
"request_enhanced_criminal_record_check": boolean,
"request_vulnerable_sector_criminal_record_check": boolean,
"request_motor_vehicle_records": boolean,
"request_education_verification": boolean,
"request_employment_verification": boolean,
"request_us_criminal_softcheck": boolean,
"request_us_ssn_verification": boolean,
"request_employer_references": boolean,
"request_address_references": boolean,
"request_employer_phone_references": boolean,
"request_address_phone_references": boolean,
"request_international_criminal_record_check": boolean,
"request_soquij": boolean,
"request_instant_verify_employment": boolean,
"request_instant_verify_education": boolean,
"request_instant_verify_credential": boolean,
"employer_references_min": int,
"employer_references_max": int,
"address_references_min": int,
"address_references_max": int,
"employment_verification_min": int,
"employment_verification_max": int,
"education_verification_min": int,
"education_verification_max": int,
"credential_verification_min": int,
"credential_verification_max": int,
"credential_verification_level": string,
"education_verification_level": string,
"employer_references_years": int,
"address_references_years": int,
"employment_verification_years": int,
"employment_verification_years_or_individually": string,
"address_references_years_or_individually": string,
"employer_references_years_or_individually": string,
"us_criminal_record_check_years": int,
"applicant_login": boolean,
"exclude_softcheck_possible_matches": boolean,
"workable_fast_complete": boolean,
"review_all_negative_mvr_results": boolean,
"limit_education_verifications": boolean
},
"billing_plan": {},
"google_analytics_key": string,
"adwords_key": string,
"adwords_conversion_key": string,
"external_domain": string,
}
},
"property": {
"id": string ,
"status": string,
"get_status_display": string,
"created": string ,
"modified": string ,
"last_updated": string ,
"building": string,
"building_code": string,
"address": string,
"city": string,
"province_state": string ,
"country": string ,
"postal_code": string,
"is_active": boolean,
"owner": {
"id": string ,
"email": string,
"team": {
"id": string ,
"name": string,
"country": string ,
"industry": string,
"team_type": string,
"internal_name": string,
"app_url": string,
"compliance_region": {
"id": string ,
"name": string,
"country": string ,
"team_type": string,
"sub_region": string,
"default": boolean,
"score_value_field": string,
"score_label_field": string,
"show_legal_us": boolean,
"show_credit_report": boolean,
"show_fcra": boolean,
"require_address_history": boolean
},
"settings_config": {
"get_org_name": string,
"org_name": string,
"org_logo_link": string,
"org_primary_color": string,
"whitelabel_report": boolean,
"whitelabel_emails": boolean,
"compact_pdf_report": boolean,
"behavioural_test_req": boolean,
"emergency_contact_req": boolean,
"personal_ref_req": boolean,
"education_req": boolean,
"tenancy_years_amount_req": int,
"tenancy_ref_amount_req": int,
"tenancy_ref_email_req": boolean,
"tenancy_ref_phone_req": boolean,
"employer_years_amount_req": int,
"employer_ref_req": boolean,
"employer_ref_email_req": boolean,
"employer_ref_phone_req": boolean,
"document_required": boolean,
"cover_letter_req": boolean,
"government_id_req": boolean,
"proof_of_income_req": boolean,
"resume_req": boolean,
"visa_req": boolean,
"personal_ref_amount_req": int,
"passport_req": boolean,
"hide_detailed_financial": boolean,
"hide_sin_ssn": boolean,
"hide_date_of_birth": boolean,
"enable_rcmp_reflow": boolean,
"hide_id_verification_photos": boolean,
"hide_current_address": boolean,
"require_id_with_address": boolean,
"hide_activity_log": boolean,
"redirect_url": string,
"custom_tracks": [],
"my_crc_region": string,
"hide_ssn_trace": boolean,
"request_base": boolean,
"request_behavioural": boolean,
"request_softcheck": boolean,
"request_equifax": boolean,
"request_identity_verification": boolean,
"request_enhanced_identity_verification": boolean,
"request_criminal_record_check": boolean,
"request_enhanced_criminal_record_check": boolean,
"request_vulnerable_sector_criminal_record_check": boolean,
"request_motor_vehicle_records": boolean,
"request_education_verification": boolean,
"request_employment_verification": boolean,
"request_us_criminal_softcheck": boolean,
"request_us_ssn_verification": boolean,
"request_employer_references": boolean,
"request_address_references": boolean,
"request_employer_phone_references": boolean,
"request_address_phone_references": boolean,
"request_international_criminal_record_check": boolean,
"request_soquij": boolean,
"request_instant_verify_employment": boolean,
"request_instant_verify_education": boolean,
"request_instant_verify_credential": boolean,
"employer_references_min": int,
"employer_references_max": int,
"address_references_min": int,
"address_references_max": int,
"employment_verification_min": int,
"employment_verification_max": int,
"education_verification_min": int,
"education_verification_max": int,
"credential_verification_min": int,
"credential_verification_max": int,
"credential_verification_level": string,
"education_verification_level": string,
"employer_references_years": int,
"address_references_years": int,
"employment_verification_years": int,
"employment_verification_years_or_individually": string,
"address_references_years_or_individually": string,
"employer_references_years_or_individually": string,
"us_criminal_record_check_years": int,
"applicant_login": boolean,
"exclude_softcheck_possible_matches": boolean,
"workable_fast_complete": boolean,
"review_all_negative_mvr_results": boolean,
"limit_education_verifications": boolean
},
"billing_plan": {
},
"google_analytics_key": string,
"adwords_key": string,
"adwords_conversion_key": string,
"external_domain": string
}
},
"listing_count": int,
"full_address": string,
"url_code": string
},
"applicant_count": int,
"new_applicant_count": int,
"is_psychometric_required": boolean,
"notification_list": [
{
"id": string ,
"email": string,
"team": {
"id": string ,
"name": string,
"country": string ,
"industry": string,
"team_type": string,
"internal_name": string,
"app_url": string,
"compliance_region": {
"id": string ,
"name": string,
"country": string ,
"team_type": string,
"sub_region": string,
"default": boolean,
"score_value_field": string,
"score_label_field": string,
"show_legal_us": boolean,
"show_credit_report": boolean,
"show_fcra": boolean,
"require_address_history": boolean
},
"settings_config": {
"get_org_name": string,
"org_name": string,
"org_logo_link": string,
"org_primary_color": string,
"whitelabel_report": boolean,
"whitelabel_emails": boolean,
"compact_pdf_report": boolean,
"behavioural_test_req": boolean,
"emergency_contact_req": boolean,
"personal_ref_req": boolean,
"education_req": boolean,
"tenancy_years_amount_req": int,
"tenancy_ref_amount_req": int,
"tenancy_ref_email_req": boolean,
"tenancy_ref_phone_req": boolean,
"employer_years_amount_req": int,
"employer_ref_req": boolean,
"employer_ref_email_req": boolean,
"employer_ref_phone_req": boolean,
"document_required": boolean,
"cover_letter_req": boolean,
"government_id_req": boolean,
"proof_of_income_req": boolean,
"resume_req": boolean,
"visa_req": boolean,
"personal_ref_amount_req": int,
"passport_req": boolean,
"hide_detailed_financial": boolean,
"hide_sin_ssn": boolean,
"hide_date_of_birth": boolean,
"enable_rcmp_reflow": boolean,
"hide_id_verification_photos": boolean,
"hide_current_address": boolean,
"require_id_with_address": boolean,
"hide_activity_log": boolean,
"redirect_url": string,
"custom_tracks": [],
"my_crc_region": string,
"hide_ssn_trace": boolean,
"request_base": boolean,
"request_behavioural": boolean,
"request_softcheck": boolean,
"request_equifax": boolean,
"request_identity_verification": boolean,
"request_enhanced_identity_verification": boolean,
"request_criminal_record_check": boolean,
"request_enhanced_criminal_record_check": boolean,
"request_vulnerable_sector_criminal_record_check": boolean,
"request_motor_vehicle_records": boolean,
"request_education_verification": boolean,
"request_employment_verification": boolean,
"request_us_criminal_softcheck": boolean,
"request_us_ssn_verification": boolean,
"request_employer_references": boolean,
"request_address_references": boolean,
"request_employer_phone_references": boolean,
"request_address_phone_references": boolean,
"request_international_criminal_record_check": boolean,
"request_soquij": boolean,
"request_instant_verify_employment": boolean,
"request_instant_verify_education": boolean,
"request_instant_verify_credential": boolean,
"employer_references_min": int,
"employer_references_max": int,
"address_references_min": int,
"address_references_max": int,
"employment_verification_min": int,
"employment_verification_max": int,
"education_verification_min": int,
"education_verification_max": int,
"credential_verification_min": int,
"credential_verification_max": int,
"credential_verification_level": string,
"education_verification_level": string,
"employer_references_years": int,
"address_references_years": int,
"employment_verification_years": int,
"employment_verification_years_or_individually": string,
"address_references_years_or_individually": string,
"employer_references_years_or_individually": string,
"us_criminal_record_check_years": int,
"applicant_login": boolean,
"exclude_softcheck_possible_matches": boolean,
"workable_fast_complete": boolean,
"review_all_negative_mvr_results": boolean,
"limit_education_verifications": boolean
},
"billing_plan": {
},
"google_analytics_key": string,
"adwords_key": string,
"adwords_conversion_key": string,
"external_domain": string
}
}
}
],
"selected_application": {
"is_selected": boolean,
"applicants": []
},
"use_team_link": boolean,
"length_of_lease": string
}
```
{% endcode %}
{% endtab %}
{% tab title="Example response" %}
{% code title="application/json" %}
```json
{
"id": "d7fac660-ba71-450e-a254-cc69ba6bfe5d",
"created": "2022-01-21T00:42:26.040770Z",
"modified": "2022-01-21T00:42:26.040814Z",
"last_updated": "2022-01-21T00:42:26.040837Z",
"name": "Andrew",
"unit": null,
"move_in_date": null,
"move_in_immediately": false,
"rent": "1000.00",
"rent_range": null,
"security_deposit_amount": null,
"pet_deposit": false,
"pet_deposit_amount": null,
"storage_locker": false,
"property_manager_terms": null,
"is_active": true,
"is_public": false,
"url_code": "",
"is_placeholder": false,
"owner": {
"id": "d4129823-0ccd-4fa3-99b2-c30baaa01c89",
"email": "email@certn.co",
"team": {
"id": "9f887774-d577-4d2f-b109-82951065993b",
"name": "Team",
"country": "CA",
"industry": "",
"team_type": "PM",
"internal_name": "Team",
"app_url": "https://api.certn.co/",
"compliance_region": {
"id": "eac92691-2ba5-46c6-8e76-1ca85db2a142",
"name": "Initial",
"country": "CA",
"team_type": "PM",
"sub_region": "",
"default": true,
"score_value_field": "certn_score",
"score_label_field": "report_summary.report_result_label",
"show_legal_us": false,
"show_credit_report": true,
"show_fcra": false,
"require_address_history": true
},
"settings_config": {
"get_org_name": "Team",
"org_name": "Team",
"org_logo_link": "https://certn-images.s3.amazonaws.com/yourlogo_here_copy.png",
"org_primary_color": "#35c9b3",
"whitelabel_report": false,
"whitelabel_emails": false,
"compact_pdf_report": false,
"behavioural_test_req": false,
"emergency_contact_req": false,
"personal_ref_req": false,
"education_req": false,
"tenancy_years_amount_req": 4,
"tenancy_ref_amount_req": 1,
"tenancy_ref_email_req": false,
"tenancy_ref_phone_req": false,
"employer_years_amount_req": 0,
"employer_ref_req": false,
"employer_ref_email_req": false,
"employer_ref_phone_req": false,
"document_required": false,
"cover_letter_req": false,
"government_id_req": false,
"proof_of_income_req": false,
"resume_req": false,
"visa_req": false,
"personal_ref_amount_req": 0,
"passport_req": false,
"hide_detailed_financial": false,
"hide_sin_ssn": true,
"hide_date_of_birth": false,
"enable_rcmp_reflow": false,
"hide_id_verification_photos": false,
"hide_current_address": true,
"require_id_with_address": false,
"hide_activity_log": true,
"redirect_url": null,
"custom_tracks": [],
"my_crc_region": null,
"hide_ssn_trace": true,
"request_base": true,
"request_behavioural": true,
"request_softcheck": true,
"request_equifax": false,
"request_identity_verification": false,
"request_enhanced_identity_verification": false,
"request_criminal_record_check": false,
"request_enhanced_criminal_record_check": false,
"request_vulnerable_sector_criminal_record_check": false,
"request_motor_vehicle_records": false,
"request_education_verification": false,
"request_employment_verification": false,
"request_us_criminal_softcheck": false,
"request_us_ssn_verification": false,
"request_employer_references": false,
"request_address_references": true,
"request_employer_phone_references": false,
"request_address_phone_references": false,
"request_international_criminal_record_check": false,
"request_soquij": false,
"request_instant_verify_employment": false,
"request_instant_verify_education": false,
"request_instant_verify_credential": false,
"employer_references_min": 3,
"employer_references_max": 3,
"address_references_min": 2,
"address_references_max": 2,
"employment_verification_min": 3,
"employment_verification_max": 3,
"education_verification_min": 1,
"education_verification_max": 1,
"credential_verification_min": 1,
"credential_verification_max": 1,
"credential_verification_level": "ALL",
"education_verification_level": "ALL",
"employer_references_years": 5,
"address_references_years": 3,
"employment_verification_years": 5,
"employment_verification_years_or_individually": "INDIVIDUALLY",
"address_references_years_or_individually": "INDIVIDUALLY",
"employer_references_years_or_individually": "INDIVIDUALLY",
"us_criminal_record_check_years": 7,
"applicant_login": false,
"exclude_softcheck_possible_matches": false,
"workable_fast_complete": false,
"review_all_negative_mvr_results": false,
"limit_education_verifications": false
},
"billing_plan": {},
"google_analytics_key": "",
"adwords_key": "",
"adwords_conversion_key": "",
"external_domain": ""
}
},
"property": {
"id": "bc3e83ef-0656-42d0-820b-1e2fac8d40ba",
"status": "N",
"get_status_display": "No Vacancy",
"created": "2022-01-20T23:14:13.817172Z",
"modified": "2022-01-20T23:14:13.817198Z",
"last_updated": "2022-01-20T23:14:13.817227Z",
"building": null,
"building_code": null,
"address": "1017 Fort Street",
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": null,
"is_active": true,
"owner": {
"id": "d4129823-0ccd-4fa3-99b2-c30baaa01c89",
"email": "email@certn.co",
"team": {
"id": "9f887774-d577-4d2f-b109-82951065993b",
"name": "Team",
"country": "CA",
"industry": "",
"team_type": "PM",
"internal_name": "Team",
"app_url": "https://api.certn.co/",
"compliance_region": {
"id": "eac92691-2ba5-46c6-8e76-1ca85db2a142",
"name": "Initial",
"country": "CA",
"team_type": "PM",
"sub_region": "",
"default": true,
"score_value_field": "certn_score",
"score_label_field": "report_summary.report_result_label",
"show_legal_us": false,
"show_credit_report": true,
"show_fcra": false,
"require_address_history": true
},
"settings_config": {
"get_org_name": "Team",
"org_name": "Team",
"org_logo_link": "https://certn-images.s3.amazonaws.com/yourlogo_here_copy.png",
"org_primary_color": "#35c9b3",
"whitelabel_report": false,
"whitelabel_emails": false,
"compact_pdf_report": false,
"behavioural_test_req": false,
"emergency_contact_req": false,
"personal_ref_req": false,
"education_req": false,
"tenancy_years_amount_req": 4,
"tenancy_ref_amount_req": 1,
"tenancy_ref_email_req": false,
"tenancy_ref_phone_req": false,
"employer_years_amount_req": 0,
"employer_ref_req": false,
"employer_ref_email_req": false,
"employer_ref_phone_req": false,
"document_required": false,
"cover_letter_req": false,
"government_id_req": false,
"proof_of_income_req": false,
"resume_req": false,
"visa_req": false,
"personal_ref_amount_req": 0,
"passport_req": false,
"hide_detailed_financial": false,
"hide_sin_ssn": true,
"hide_date_of_birth": false,
"enable_rcmp_reflow": false,
"hide_id_verification_photos": false,
"hide_current_address": true,
"require_id_with_address": false,
"hide_activity_log": true,
"redirect_url": null,
"custom_tracks": [],
"my_crc_region": null,
"hide_ssn_trace": true,
"request_base": true,
"request_behavioural": true,
"request_softcheck": true,
"request_equifax": false,
"request_identity_verification": false,
"request_enhanced_identity_verification": false,
"request_criminal_record_check": false,
"request_enhanced_criminal_record_check": false,
"request_vulnerable_sector_criminal_record_check": false,
"request_motor_vehicle_records": false,
"request_education_verification": false,
"request_employment_verification": false,
"request_us_criminal_softcheck": false,
"request_us_ssn_verification": false,
"request_employer_references": false,
"request_address_references": true,
"request_employer_phone_references": false,
"request_address_phone_references": false,
"request_international_criminal_record_check": false,
"request_soquij": false,
"request_instant_verify_employment": false,
"request_instant_verify_education": false,
"request_instant_verify_credential": false,
"employer_references_min": 3,
"employer_references_max": 3,
"address_references_min": 2,
"address_references_max": 2,
"employment_verification_min": 3,
"employment_verification_max": 3,
"education_verification_min": 1,
"education_verification_max": 1,
"credential_verification_min": 1,
"credential_verification_max": 1,
"credential_verification_level": "ALL",
"education_verification_level": "ALL",
"employer_references_years": 5,
"address_references_years": 3,
"employment_verification_years": 5,
"employment_verification_years_or_individually": "INDIVIDUALLY",
"address_references_years_or_individually": "INDIVIDUALLY",
"employer_references_years_or_individually": "INDIVIDUALLY",
"us_criminal_record_check_years": 7,
"applicant_login": false,
"exclude_softcheck_possible_matches": false,
"workable_fast_complete": false,
"review_all_negative_mvr_results": false,
"limit_education_verifications": false
},
"billing_plan": {
},
"google_analytics_key": "",
"adwords_key": "",
"adwords_conversion_key": "",
"external_domain": ""
}
},
"listing_count": 1,
"full_address": "1017 Fort Street Victoria QC CA ",
"url_code": "bc3e83ef-0656-42d0-820b-1e2fac8d40ba"
},
"applicant_count": 0,
"new_applicant_count": 0,
"is_psychometric_required": true,
"notification_list": [
{
"id": "5946ace5-e817-4b73-9657-e631aea21f38",
"email": "email@certn.co",
"team": {
"id": "9f887774-d577-4d2f-b109-82951065993b",
"name": "Team",
"country": "CA",
"industry": "",
"team_type": "PM",
"internal_name": "Team",
"app_url": "https://api.certn.co/",
"compliance_region": {
"id": "eac92691-2ba5-46c6-8e76-1ca85db2a142",
"name": "Initial",
"country": "CA",
"team_type": "PM",
"sub_region": "",
"default": true,
"score_value_field": "certn_score",
"score_label_field": "report_summary.report_result_label",
"show_legal_us": false,
"show_credit_report": true,
"show_fcra": false,
"require_address_history": true
},
"settings_config": {
"get_org_name": "Team",
"org_name": "Team",
"org_logo_link": "https://certn-images.s3.amazonaws.com/yourlogo_here_copy.png",
"org_primary_color": "#35c9b3",
"whitelabel_report": false,
"whitelabel_emails": false,
"compact_pdf_report": false,
"behavioural_test_req": false,
"emergency_contact_req": false,
"personal_ref_req": false,
"education_req": false,
"tenancy_years_amount_req": 4,
"tenancy_ref_amount_req": 1,
"tenancy_ref_email_req": false,
"tenancy_ref_phone_req": false,
"employer_years_amount_req": 0,
"employer_ref_req": false,
"employer_ref_email_req": false,
"employer_ref_phone_req": false,
"document_required": false,
"cover_letter_req": false,
"government_id_req": false,
"proof_of_income_req": false,
"resume_req": false,
"visa_req": false,
"personal_ref_amount_req": 0,
"passport_req": false,
"hide_detailed_financial": false,
"hide_sin_ssn": true,
"hide_date_of_birth": false,
"enable_rcmp_reflow": false,
"hide_id_verification_photos": false,
"hide_current_address": true,
"require_id_with_address": false,
"hide_activity_log": true,
"redirect_url": null,
"custom_tracks": [],
"my_crc_region": null,
"hide_ssn_trace": true,
"request_base": true,
"request_behavioural": true,
"request_softcheck": true,
"request_equifax": false,
"request_identity_verification": false,
"request_enhanced_identity_verification": false,
"request_criminal_record_check": false,
"request_enhanced_criminal_record_check": false,
"request_vulnerable_sector_criminal_record_check": false,
"request_motor_vehicle_records": false,
"request_education_verification": false,
"request_employment_verification": false,
"request_us_criminal_softcheck": false,
"request_us_ssn_verification": false,
"request_employer_references": false,
"request_address_references": true,
"request_employer_phone_references": false,
"request_address_phone_references": false,
"request_international_criminal_record_check": false,
"request_soquij": false,
"request_instant_verify_employment": false,
"request_instant_verify_education": false,
"request_instant_verify_credential": false,
"employer_references_min": 3,
"employer_references_max": 3,
"address_references_min": 2,
"address_references_max": 2,
"employment_verification_min": 3,
"employment_verification_max": 3,
"education_verification_min": 1,
"education_verification_max": 1,
"credential_verification_min": 1,
"credential_verification_max": 1,
"credential_verification_level": "ALL",
"education_verification_level": "ALL",
"employer_references_years": 5,
"address_references_years": 3,
"employment_verification_years": 5,
"employment_verification_years_or_individually": "INDIVIDUALLY",
"address_references_years_or_individually": "INDIVIDUALLY",
"employer_references_years_or_individually": "INDIVIDUALLY",
"us_criminal_record_check_years": 7,
"applicant_login": false,
"exclude_softcheck_possible_matches": false,
"workable_fast_complete": false,
"review_all_negative_mvr_results": false,
"limit_education_verifications": false
},
"billing_plan": {
},
"google_analytics_key": "",
"adwords_key": "",
"adwords_conversion_key": "",
"external_domain": ""
}
}
],
"selected_application": {
"is_selected": false,
"applicants": []
},
"use_team_link": false,
"length_of_lease": null
}
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="400: Bad Request Missing field, wrong data type" %}
This may be happening because:
**You are missing required fields**
Add all the required fields to the body of your request.
**You used the wrong format or data type for a field**
Format all your fields according to their [data type](https://www.w3schools.com/js/js_json_datatypes.asp).
*See* [#400-bad-request](https://docs.certn.co/api/certn-api-v-1.0/resources/error-codes#400-bad-request "mention") *for more details.*
{% endtab %}
{% endtabs %}