> For the complete documentation index, see [llms.txt](https://docs.certn.co/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters/request-flags.md).

# Request flags

## Request flags

<table><thead><tr><th width="242.23199894952438">Flag</th><th>Screen</th></tr></thead><tbody><tr><td><code>request_base</code></td><td>Informational Analysis (information_result)</td></tr><tr><td><code>request_softcheck</code></td><td><a data-mention href="/api/certn-api-v-1.0/guides/checks/softcheck.md">Softcheck</a> (risk_result)</td></tr><tr><td><code>request_equifax</code></td><td><a data-mention href="/api/certn-api-v-1.0/guides/checks/credit-check.md">Credit Check</a>(equifax_result)</td></tr><tr><td><code>request_enhanced_identity_verification</code></td><td><p><a data-mention href="/api/certn-api-v-1.0/guides/checks/enhanced-identity-verification.md">Enhanced Identity Verification</a></p><p>(enhanced_identity_verification)</p></td></tr><tr><td><code>request_criminal_record_check</code><br><br><code>request_enhanced_criminal_record_check</code></td><td><p><a data-mention href="/api/certn-api-v-1.0/guides/checks/canadian-criminal-record-check.md">Canadian Criminal Record Check</a></p><p>(rcmp_result)</p></td></tr><tr><td><code>request_soquij</code></td><td><a data-mention href="/api/certn-api-v-1.0/guides/checks/soquij.md">SOQUIJ</a><br>(soquij_result)</td></tr><tr><td><code>request_social_media_check</code></td><td><a data-mention href="/api/certn-api-v-1.0/guides/checks/social-media-check.md">Social Media Check</a><br>(social_media_check_result)</td></tr><tr><td><code>request_us_criminal_record_check_tier_1</code><br><br><code>request_us_criminal_record_check_tier_2</code><br><br><code>request_us_criminal_record_check_tier_3</code></td><td><a data-mention href="/api/certn-api-v-1.0/guides/checks/us-criminal-record-check.md">US Criminal Record Check</a> (us_criminal_record_check_result)</td></tr><tr><td><code>request_right_to_work</code></td><td><a data-mention href="/api/certn-api-v-1.0/guides/checks/australia-right-to-work-check.md">Australia Right To Work Check</a><br>(right_to_work_result)</td></tr><tr><td><code>request_uk_right_to_work</code></td><td><a data-mention href="/api/certn-api-v-1.0/guides/checks/uk-right-to-work-check.md">UK Right To Work Check</a>(uk_right_to_work_check_result)</td></tr><tr><td><code>request_uk_basic_ds_check</code></td><td><a data-mention href="/api/certn-api-v-1.0/guides/checks/basic-disclosure-scotland-check.md">Basic Disclosure Scotland Check</a>(uk_basic_ds_check_result)</td></tr><tr><td><code>request_uk_basic_dbs_check</code></td><td><a data-mention href="/api/certn-api-v-1.0/guides/checks/basic-disclosure-and-barring-service-check.md">Basic Disclosure And Barring Service Check</a>(uk_basic_dbs_check_result)</td></tr><tr><td><code>request_international_criminal_record_check</code></td><td><a data-mention href="/api/certn-api-v-1.0/guides/checks/international-criminal-record-check.md">International Criminal Record Check</a> (international_criminal_record_check_result)</td></tr><tr><td><code>request_motor_vehicle_records</code></td><td><p><a data-mention href="/api/certn-api-v-1.0/guides/checks/motor-vehicle-record-check.md">Motor Vehicle Record Check / Driver's Abstract</a></p><p>(motor_vehicle_record_result)</p></td></tr><tr><td><code>request_employment_verification</code></td><td><p><a data-mention href="/api/certn-api-v-1.0/guides/checks/employment-verification.md">Employment Verification</a></p><p>(employment_verification)</p></td></tr><tr><td><code>request_education_verification</code></td><td><p><a data-mention href="/api/certn-api-v-1.0/guides/checks/education-verification.md">Education Verification</a></p><p>(education_verification)</p></td></tr><tr><td><code>request_credential_verification</code></td><td><p><a data-mention href="/api/certn-api-v-1.0/guides/checks/credential-verification.md">Credential Verification</a></p><p>(credential_verification)</p></td></tr><tr><td><code>request_employer_references</code></td><td><p><a data-mention href="/api/certn-api-v-1.0/guides/checks/employer-reference-check.md">Employment Reference Check</a></p><p>(reference_result)</p><p></p><p>Mutually exclusive with <code>request_employer_phone_references</code>.<br>*<em>Requires employer_questionaire_id</em>.</p></td></tr><tr><td><code>request_employer_phone_references</code></td><td><p><a data-mention href="/api/certn-api-v-1.0/guides/checks/employer-reference-check.md">Employment Reference Check</a></p><p>(reference_result)</p><p></p><p>Mutually exclusive with <code>request_employer_phone_references</code>.<br>*<em>Requires employer_questionaire_id</em>.</p></td></tr><tr><td><code>request_address_references</code></td><td><p><a data-mention href="/api/certn-api-v-1.0/guides/checks/address-reference-check.md">Address Reference Check</a></p><p>(reference_result)</p><p></p><p>Mutually exclusive with <code>request_employer_references</code>.<br>*<em>Requires employer_questionaire_id</em>.</p></td></tr><tr><td><code>request_address_phone_references</code></td><td><p><a data-mention href="/api/certn-api-v-1.0/guides/checks/address-reference-check.md">Address Reference Check</a></p><p>(reference_result)</p><p></p><p>Mutually exclusive with <code>request_address_references</code>.<br>*<em>Requires address_questionaire_id</em>.</p></td></tr></tbody></table>

### Credential Verification flags

| Flag                            | Type           | Note                                                                                                                                                                                                                                                            |
| ------------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `credential_verification_level` | string \<enum> | <p>One of: <code>ALL</code>, <code>HIGHEST</code> <br>All credentials listed / Highest level credential listed<br><br>Use with <a href="/api/certn-api-v-1.0/api-reference/resources/application-parameters.md#credential"><code>highest\_level</code></a> </p> |
| `credential_verification_min`   | int            | <p>Minimum number of credentials to verify<br><br>number < <code>credential\_verification\_max</code></p>                                                                                                                                                       |
| `credential_verification_max`   | int            | <p>Maximum number of credentials to verify<br><br>number > <code>credential\_verification\_min</code></p>                                                                                                                                                       |

### Education Verification flags

| Flag                           | Type           | Note                                                                                                                                                                                                                                                   |
| ------------------------------ | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `education_verification_level` | string \<enum> | <p><code>ALL</code>, <code>HIGHEST</code> <br>All credentials listed / Highest level credential listed<br><br>Use with <a href="/api/certn-api-v-1.0/api-reference/resources/application-parameters.md#education"><code>highest\_level</code></a> </p> |
| `education_verification_min`   | int            | <p>Minimum number of educations to verify<br><br>number < <code>education\_verification\_max</code></p>                                                                                                                                                |
| `education_verification_max`   | int            | <p>Maximum number of educations to verify<br><br>number > <code>education\_verification\_min</code></p>                                                                                                                                                |

### Employment Reference flags&#x20;

| Flag                                       | Type           | Note                                                                                                                                                                                                                        |
| ------------------------------------------ | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `employer_reference_years_or_individually` | string \<enum> | <p><code>YEARS</code>, <code>INDIVIDUALLY</code><br>All employers for the past x years / Specific number of employers (>= min, <= max)</p>                                                                                  |
| `employer_references_years`                | int            | <p><code>3</code>, <code>5</code> or <code>7</code><br><br>Use when <code>years\_or\_individually</code> = <code>YEARS</code></p>                                                                                           |
| `employer_references_min`                  | int            | <p>Minimum number of employer references to contact</p><p></p><p>number <= <code>employer\_references\_max</code><br><br>Use when <code>employer\_reference\_years\_or\_individually</code> = <code>INDIVIDUALLY</code></p> |
| `employer_references_max`                  | int            | <p>Maximum number of employer references to contact<br><br>number >= <code>employer\_references\_min</code><br><br>Use when <code>employer\_reference\_years\_or\_individually</code> = <code>INDIVIDUALLY</code></p>       |