1. Introduction

The INTERPOL API is an essential tool for verifying information about individuals wanted by INTERPOL. It is widely used for compliance, ESG, anti-money laundering (AML), and risk analysis.


2. Base URL

The API is hosted at the following address:

https://api.directd.com.br

Endpoint

GET /api/Interpol

Description: Endpoint for querying individuals wanted by INTERPOL.

Note: This query does not generate certificates.


4. Authentication

To access this API, you must provide an authentication token.

Authentication Rules:

  1. The token must be sent as a parameter in the request URL.
  2. The token is mandatory to perform queries.

5. API Fields

Personal Information

  • Name: Name of the wanted individual.
  • Surname: Surname of the individual.
  • Gender: Gender of the individual.
  • Date of Birth: Date of birth of the individual.
  • Place of Birth: City or country of birth.

Physical Characteristics

  • Height: Height of the individual (in cm).
  • Distinguishing Marks: Unique marks or characteristics (such as tattoos or scars).

Additional Information

  • Photo List: URLs of images of the individual.
  • Languages Spoken: Languages known by the individual.
  • Nationalities: Nationalities associated with the individual.

Occurrences

  • Country: Country related to the occurrence.
  • Charge: Additional details about the case.

6. Parameters

| Name | Type | Mandatory | Description | |-----------|--------|-----------|--------------------------------------------------| | NOME | string | No | First name of the individual (case-insensitive).| | SOBRENOME | string | No | Surname of the individual (case-insensitive). | | TOKEN | string | Yes | Authentication token required for the query. |


7. Request Examples

Using cURL

curl 'https://api.directd.com.br/api/Interpol?NOME=John&SOBRENOME=Doe&TOKEN=your_token_here'

8. Responses

Success (200)

Example Response

{
  "metaDados": {
    "consultaNome": "INTERPOL",
    "consultaUid": "interpol-123456",
    "usuario": "Carlos",
    "mensagem": "Success",
    "apiVersao": "v3",
    "tempoExecucaoMs": 120
  },
  "retorno": {
    "interpol": {
      "pessoas": [
        {
          "sexo": "Masculino",
          "dataNascimento": "1985-05-10",
          "localNascimento": "Nova York, EUA",
          "marcasDistintivas": "Cicatriz na bochecha direita",
          "altura": "180 cm",
          "ocorrencias": [
            {
              "cobranca": "Roubo qualificado",
              "pais": "Estados Unidos"
            }
          ],
          "fotos": [
            "https://interpol.int/image1.jpg",
            "https://interpol.int/image2.jpg"
          ],
          "linguasFaladas": [
            "Inglês",
            "Espanhol"
          ],
          "nacionalidades": [
            "Americano"
          ]
        }
      ],
      "nome": "John",
      "sobrenome": "Doe",
      "dataConsulta": "2024-01-15"
    },
    "observacao": "Indivíduo procurado pela INTERPOL."
  }
}

9. Common Errors

NomeTipoObrigatórioDescrição
400numberNãoInvalid Request: Incorrect parameters.
401numberNãoUnauthorized: Incorrect credentials.
403numberNãoForbidden: Insufficient balance.
404numberNãoNot Found: No matching individual found.
408numberNãoTimeout: Server could not process the request.
500numberNãoInternal Error: Contact support for assistance.
503numberNãoMaintenance: Resource temporarily unavailable.

10. Important Notes

  • The service returns only public data available in INTERPOL's database.
  • At least one parameter (NOME or SOBRENOME) must be provided.
  • Ensure the correct token is used to avoid authentication errors.