# Softcheck

Softcheck is a search of thousands of international data sources for identification of potential illegal behavior, criminal activity, incidents of fraud, regulatory violations and negative media information. This service also includes searches of country sanction lists, exposed persons lists, sex offender registries, terrorist registries and most wanted lists from around the globe.

### Availability

This check is available in **Canada** :flag\_ca:

This check is available for a [**quickscreen**](https://docs.certn.co/api/certn-api-v-1.0/faq#what-is-a-quickscreen-and-how-do-i-use-it) :white\_check\_mark:&#x20;

{% tabs %}
{% tab title="Canada" %}

| Industry            | Availability | Endpoints                                                                                                                                                                                                                                                                                                                      |
| ------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Human Resources     | Yes          | <ul><li><a href="../../../api-reference/hr#screen-an-applicant-instantly">Quickscreen</a> <span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span></li><li><a href="../../../api-reference/hr#invite-an-applicant">Invite</a> <span data-gb-custom-inline data-tag="emoji" data-code="1f4e9">📩</span></li></ul> |
| Property Management | Yes          | <ul><li><a href="../../../api-reference/pm#screen-an-applicant-instantly">Quickscreen</a> <span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span></li><li><a href="../../../api-reference/pm#invite-an-applicant">Invite</a> <span data-gb-custom-inline data-tag="emoji" data-code="1f4e9">📩</span></li></ul> |

{% endtab %}
{% endtabs %}

### Parameters

#### Request flag

Include this flag in the body of your request:

[`request_softcheck`](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters/request-flags)&#x20;

#### Invite parameters

To invite an applicant to complete a screen, include this parameter in the body of your request:

* `email`

See all available [application-parameters](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters "mention")

#### Quickscreen parameters

To complete a quickscreen, include these parameters in the body of your request:

* [`information`](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters#information)
  * `first_name`&#x20;
  * `last_name`&#x20;
  * [`addresses`](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters#address) (min 1)
* [`position_or_property_location`](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters#specialization)

{% hint style="warning" %}
Make sure to obtain the [proof of consent](https://docs.certn.co/api/certn-api-v-1.0/guides/use-the-api/consent) from your applicant **before** running the quickscreen.
{% endhint %}

#### Example request <a href="#example" id="example"></a>

```json
{
    "request_softcheck": true,
    "information": {
        "first_name": "Andrew",
        "last_name": "McLeod",
        "addresses": [{
                "address": "1006 Fort St Unit 300",
                "city": "Victoria",
                "province_state": "BC",
                "country": "CA",
                "current": true
            }
        ],
    },
    "position_or_property_location": {
        "address": "2680 Blanshard St Unit 3",
        "city": "Victoria",
        "province_state": "BC",
        "country": "CA",
        "postal_code": "V8T5E1",
        "location_type": "Position Location"
    }
}
```

### Report

Report field: [`risk_result`](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/report-field-mappings#softcheck)

### Test data <a href="#static-sandbox-server-responses" id="static-sandbox-server-responses"></a>

Send Softcheck requests with the following data on our [demo environment](https://docs.certn.co/api/certn-api-v-1.0/getting-started/demo-account) to retrieve our pre-filled reports.

<table><thead><tr><th width="181">First name</th><th>Last name</th><th>Address</th><th width="133">Result</th></tr></thead><tbody><tr><td>Andrew</td><td>McLeod</td><td>Canadian</td><td>Random</td></tr><tr><td>Sebastien</td><td>Normandin</td><td>Canadian</td><td>Random</td></tr></tbody></table>

{% hint style="info" %}
When requesting a pre-filled report via Softcheck, you only need to enter the First Name and Last Name. Leave the other fields blank or add placeholder data.
{% endhint %}
