> 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/api-reference/resources/application-parameters/package-settings.md).

# Package settings

Package settings are optional settings which relate to types of checks. These can be defined when running a check or when setting up a package of checks to run later.

## Package settings

<table data-full-width="true"><thead><tr><th width="300">settings field</th><th width="103"></th><th>Relevant Check</th><th>Notes</th></tr></thead><tbody><tr><td><code>requested_countries</code></td><td>list [string]</td><td><a data-mention href="/api/guides/checks/international-criminal-record-check.md">International Criminal Record Check</a></td><td>optional, default superteam country.  Accepts <a href="https://docs.certn.co/api/api-reference/resources/region-codes#countries">ISO country code</a> format.</td></tr><tr><td><code>us_criminal_record_check_years</code></td><td>int</td><td><a data-mention href="/api/guides/checks/us-criminal-record-check.md">US Criminal Record Check</a></td><td>optional, default team setting</td></tr><tr><td><code>employer_questionaire_id</code></td><td>string &#x3C;uuid></td><td><a data-mention href="/api/guides/checks/employer-reference-check.md">Employment Reference Check</a></td><td>optional</td></tr><tr><td><code>employer_references_min</code></td><td>int</td><td><a data-mention href="/api/guides/checks/employer-reference-check.md">Employment Reference Check</a></td><td>optional, default 1</td></tr><tr><td><code>employer_references_max</code></td><td>int</td><td><a data-mention href="/api/guides/checks/employer-reference-check.md">Employment Reference Check</a></td><td>optional, default 1</td></tr><tr><td><code>employer_references_years</code></td><td>int</td><td><a data-mention href="/api/guides/checks/employer-reference-check.md">Employment Reference Check</a></td><td>optional, default 3</td></tr><tr><td><code>employer_references_years_or_individually</code></td><td>string &#x3C;Enum></td><td><a data-mention href="/api/guides/checks/employer-reference-check.md">Employment Reference Check</a></td><td>optional, default "INDIVIDUALLY". One of: "YEARS", or "INDIVIDUALLY"</td></tr><tr><td><code>address_questionaire_id</code></td><td>string &#x3C;uuid></td><td><a data-mention href="/api/guides/checks/address-reference-check.md">Address Reference Check</a></td><td>optional</td></tr><tr><td><code>address_references_min</code></td><td>int</td><td><a data-mention href="/api/guides/checks/address-reference-check.md">Address Reference Check</a></td><td>optional, default 1</td></tr><tr><td><code>address_references_max</code></td><td>int</td><td><a data-mention href="/api/guides/checks/address-reference-check.md">Address Reference Check</a></td><td>optional, default 1</td></tr><tr><td><code>address_references_years</code></td><td>int</td><td><a data-mention href="/api/guides/checks/address-reference-check.md">Address Reference Check</a></td><td>optional, default 3</td></tr><tr><td><code>address_references_years_or_individually</code></td><td>string &#x3C;Enum></td><td><a data-mention href="/api/guides/checks/address-reference-check.md">Address Reference Check</a></td><td>optional, default "INDIVIDUALLY". One of: "YEARS", or "INDIVIDUALLY"</td></tr><tr><td><code>employment_verification_min</code></td><td>int</td><td><a data-mention href="/api/guides/checks/employment-verification.md">Employment Verification</a></td><td>optional, default 1</td></tr><tr><td><code>employment_verification_max</code></td><td>int</td><td><a data-mention href="/api/guides/checks/employment-verification.md">Employment Verification</a></td><td>optional, default 1</td></tr><tr><td><code>employment_verification_years</code></td><td>int</td><td><a data-mention href="/api/guides/checks/employment-verification.md">Employment Verification</a></td><td>optional, default 3</td></tr><tr><td><code>employment_verification_years_or_individually</code></td><td>string &#x3C;Enum></td><td><a data-mention href="/api/guides/checks/employment-verification.md">Employment Verification</a></td><td>optional, default "INDIVIDUALLY". One of: "YEARS", or "INDIVIDUALLY"</td></tr><tr><td><code>education_verification_min</code></td><td>int</td><td><a data-mention href="/api/guides/checks/education-verification.md">Education Verification</a></td><td>optional, default 1</td></tr><tr><td><code>education_verification_max</code></td><td>int</td><td><a data-mention href="/api/guides/checks/education-verification.md">Education Verification</a></td><td>optional, default 1</td></tr><tr><td><code>education_verification_level</code></td><td>string &#x3C;Enum></td><td><a data-mention href="/api/guides/checks/education-verification.md">Education Verification</a></td><td>optional, default "ALL". One of: "ALL", or "HIGHEST".</td></tr><tr><td><code>credential_verification_min</code></td><td>int</td><td><a data-mention href="/api/guides/checks/credential-verification.md">Credential Verification</a></td><td>optional, default 1</td></tr><tr><td><code>credential_verification_max</code></td><td>int</td><td><a data-mention href="/api/guides/checks/credential-verification.md">Credential Verification</a></td><td>optional, default 1</td></tr><tr><td><code>credential_verification_level</code></td><td>string &#x3C;Enum></td><td><a data-mention href="/api/guides/checks/credential-verification.md">Credential Verification</a></td><td>optional, default "ALL". One of: "ALL", or "HIGHEST".</td></tr><tr><td><code>volunteer_role</code></td><td></td><td></td><td>optional, default ""</td></tr><tr><td><code>volunteer_organization</code></td><td></td><td></td><td>optional, default ""</td></tr><tr><td><code>role_or_position_title</code></td><td>string</td><td><a data-mention href="/api/guides/checks/basic-disclosure-and-barring-service-check.md">Basic Disclosure And Barring Service Check</a></td><td>optional, default ""</td></tr><tr><td><code>employment_sector</code></td><td>string &#x3C;Enum></td><td><a data-mention href="/api/guides/checks/basic-disclosure-and-barring-service-check.md">Basic Disclosure And Barring Service Check</a></td><td>optional, one of <a data-mention href="#employment_sector-values">#employment_sector-values</a></td></tr></tbody></table>
