> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Interpol

> Background check against international lists.

**Version: 2.0**

Query international records in Interpol through the Verifik provider, using personal identification data of the user to be verified.

**Available countries:** 🇨🇴 Colombia

## Configuration

> [tab] Inputs
>
> > [accordion] Country
> >
> > **Country** `string` *required*
> >
> > Variable: `country`. Country in which the query is performed.
> >
> > **Available values:** `Colombia`
> >
> > > [!NOTE]
> > >
> > > Currently the country selector is only enabled for Colombia.
>
> > [accordion] Identification type
> >
> > **Identification type** `string` *required*
> >
> > Variable: `documentType`. Type of identity document, enabled according to the selected country.
> >
> > **Available values for Colombia:**
> >
> > * `CC`: Cédula de Ciudadanía (Colombian citizens)
> > * `PEP`: Permiso Especial de Permanencia (foreigners, mainly Venezuelan)
> > * `CE`: Cédula de Extranjería (foreign residents in Colombia)
>
> > [accordion] Identification number
> >
> > **Identification number** `string` *required*
> >
> > Variable: `documentNumber`. Identity document number of the person to query.

> [tab] Outputs
>
> #### ✅ Success
>
> > [accordion] No criminal record
> >
> > Indicates that the queried person **has no criminal record** in Interpol.
> >
> > > [!TIP]
> > >
> > > The response delivered corresponds to the complete response from the Verifik provider.
> >
> > **Response example:**
> >
> > ```json theme={null}
> > {
> >   "data": {
> >     "documentType": "CC",
> >     "documentNumber": "XXXXXXXXXX",
> >     "firstName": "FIRST_NAME",
> >     "lastName": "LAST_NAME",
> >     "fullName": "FIRST_NAME LAST_NAME",
> >     "arrayName": [
> >       "FIRST_NAME",
> >       "SECOND_NAME",
> >       "LAST_NAME_1",
> >       "LAST_NAME_2"
> >     ],
> >     "foundInInterpol": false,
> >     "details": null
> >   },
> >   "signature": {
> >     "dateTime": "June 16, 2025 4:31 PM",
> >     "message": "Certified by Verifik.co"
> >   },
> >   "id": "XXXXX"
> > }
> > ```
> >
> > **Key fields:**
> >
> > * `foundInInterpol`: `false` indicates the person has no criminal record in Interpol
> > * `details`: `null` when there is no criminal record
>
> #### 🔴 Errors
>
> > [accordion] Has criminal record
> >
> > Indicates that the person **does have a criminal record** in Interpol.
> >
> > > [!WARNING]
> > >
> > > The information returned corresponds to the provider's response.
> >
> > **Response example:**
> >
> > ```json theme={null}
> > {
> >   "data": {
> >     "documentType": "CC",
> >     "documentNumber": "XXXXXXXXXX",
> >     "firstName": "FIRST_NAME",
> >     "lastName": "LAST_NAMES",
> >     "fullName": "FIRST_NAME LAST_NAMES",
> >     "arrayName": [
> >       "FIRST_NAME",
> >       "LAST_NAME"
> >     ],
> >     "foundInInterpol": true,
> >     "details": {
> >       "totalCards": "2",
> >       "cards": [
> >         {
> >           "arrestWarrants": [
> >             {
> >               "issuingCountryId": "CO",
> >               "charge": "Description of the charges"
> >             }
> >           ],
> >           "weight": "0",
> >           "languagesSpokenIds": [
> >             "SPA"
> >           ],
> >           "height": "1.75",
> >           "sexId": "M",
> >           "countryOfBirthId": "CO",
> >           "distinguishingMarks": null,
> >           "eyesColorsId": null,
> >           "hairsId": null,
> >           "placeOfBirth": "CITY - DEPARTMENT"
> >         }
> >       ]
> >     }
> >   },
> >   "signature": {
> >     "dateTime": "June 16, 2025 4:31 PM",
> >     "message": "Certified by Verifik.co"
> >   },
> >   "id": "XXXXX"
> > }
> > ```
> >
> > **Important fields:**
> >
> > * `foundInInterpol`: `true` indicates the person was found with a criminal record
> > * `details.totalCards`: Number of records found
> > * `details.cards[].arrestWarrants`: List of arrest warrants with specific charges
> > * `signature`: Verifik provider certification with date and time of the query
>
> > [accordion] Missing data
> >
> > Occurs when not all required parameters are sent to perform the query.
> >
> > **Response example:**
> >
> > ```json theme={null}
> > {
> >   "code": "MissingParameter",
> >   "message": "missing documentType\n. missing documentNumber\n"
> > }
> > ```
> >
> > The `message` field indicates which specific parameters are missing in the request.
>
> > [accordion] No records
> >
> > Occurs when the provider indicates that no record associated with the queried identification was found (Not Found).
> >
> > **Response example:**
> >
> > ```json theme={null}
> > {
> >   "code": "NotFound",
> >   "message": "Record not found."
> > }
> > ```
> >
> > > [!NOTE]
> > >
> > > There is a difference between "no criminal record" and "no records". The first indicates the person was found and has no criminal record, while the second indicates no record of that person was found in the system.
>
> > [accordion] Unexpected error
> >
> > Occurs when an unforeseen event happens during the query process.

## Integration

**1. Capture the user's data**

Collect the country, document type, and identification number from the user in your flow.

> [!TIP]
>
> Use the [Question node](https://docs.jelou.ai/guides/nodos/pregunta.md) or [user variables](https://docs.jelou.ai/guides/variables/user.md) to capture this information.

**2. Configure the parameters**

Assign the captured values to the tool's required parameters:

* `country`: Query country
* `documentType`: Document type according to the country
* `documentNumber`: Identification number

**3. Handle the outputs**

Implement different flows based on the result:

* **✅ No criminal record:** Continue the normal process
* **🔴 Errors:** Implement retries, validations, or notify the user

**4. Store the results**

Save the response in [memory variables](https://docs.jelou.ai/guides/variables/memory.md) to use in subsequent flow decisions.

```javascript theme={null}
// Example: Check whether the person has a criminal record
if (response.data.foundInInterpol === true) {
  // Flow for persons with criminal record
} else {
  // Flow for persons without criminal record
}
```

## Additional information

**Country dependency:** the available identification type depends on the country you select in the query.

**Provider response:** the query result depends directly on the information returned by the Verifik provider.

**Result interpretation:** distinguish between no criminal record (person verified without a criminal record) and no records (person not found in the system).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.