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

# Obtenir tous les résultats de recherche KYC

> Récupérez tous les résultats de recherche KYC associés à votre compte, notamment les niveaux de risque et les constats de sanctions.

L'endpoint Obtenir tous les résultats de recherche KYC renvoie une liste de chaque vérification KYC effectuée sous votre compte. Chaque résultat inclut le niveau de risque de l'entité, son statut PEP, ses correspondances de sanctions et les constats de médias défavorables.

## Endpoint

```
GET /api/v1/monitoring/kyc_search/
```

## Requête

### En-têtes

| En-tête          | Valeur                | Requis |
| ---------------- | --------------------- | ------ |
| `x-access-token` | Votre clé secrète API | Oui    |

### Exemple

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://adhere-api.smartcomply.com/api/v1/monitoring/kyc_search/" \
    -H "x-access-token: YOUR_SECRET_KEY"
  ```
</CodeGroup>

## Réponse

### 200 OK

| Champ                                 | Type   | Description                                                    |
| ------------------------------------- | ------ | -------------------------------------------------------------- |
| `data[].id`                           | number | Identifiant unique du résultat de recherche KYC                |
| `data[].entity_name`                  | string | Nom de l'entité qui a été recherchée                           |
| `data[].branch_id`                    | number | Agence associée à cette recherche KYC                          |
| `data[].status`                       | string | Statut de la recherche (p. ex., `"completed"`)                 |
| `data[].result.risk_level`            | string | Niveau de risque évalué : `"low"`, `"medium"` ou `"high"`      |
| `data[].result.total_hits`            | number | Total des correspondances signalées dans toutes les catégories |
| `data[].result.pep_results`           | array  | Correspondances de Personnes Politiquement Exposées            |
| `data[].result.sanction_results`      | array  | Correspondances de listes de sanctions                         |
| `data[].result.social_media`          | array  | Profils de médias sociaux trouvés                              |
| `data[].result.adverse_media_results` | array  | Articles de médias défavorables                                |
| `data[].result.total_blacklist_hits`  | number | Total des indicateurs de liste noire                           |

```json theme={null}
{
  "status": "success",
  "data": [
    {
      "id": 17,
      "entity_name": "ABDUL MANAN MOHAMMAD ISHAK",
      "branch_id": 3,
      "status": "completed",
      "result": {
        "risk_level": "low",
        "total_hits": 1,
        "pep_results": [],
        "search_term": "ABDUL MANAN MOHAMMAD ISHAK",
        "social_media": [],
        "sanction_results": [
          {
            "name": "Abdul Manan Mohammad Ishak",
            "types": ["sanction", "warnings", "fitness-probity"],
            "source": "Smartcomply",
            "country": "Afghanistan",
            "recorded_date": "15 Aug. 2012"
          }
        ],
        "total_blacklist_hits": 0,
        "adverse_media_results": []
      }
    },
    {
      "id": 41,
      "entity_name": "Heritage Bank",
      "branch_id": 3,
      "status": "completed",
      "result": {
        "risk_level": "high",
        "total_hits": 5,
        "pep_results": [
          {
            "name": "Managing Director/CEO, Heritage Bank Plc",
            "gender": null,
            "source": "Smartcomply",
            "country": "Nigeria",
            "pep_types": ["pep"]
          }
        ],
        "search_term": "Heritage Bank",
        "social_media": [],
        "sanction_results": [],
        "total_blacklist_hits": 0,
        "adverse_media_results": [
          {
            "url": "https://thewillnews.com/breaking-cbn-revokes-operational-license-of-heritage-bank-plc/",
            "date": "June 5, 2024",
            "title": "CBN revokes operational license of Heritage Bank Plc",
            "types": ["adverse-media-v2-other-financial"],
            "snippet": "The Central Bank of Nigeria (CBN) has revoked the banking license of Heritage Bank Plc..."
          }
        ]
      }
    }
  ],
  "message": "Success"
}
```

### 400 Bad Request

```json theme={null}
{
  "status": "failed",
  "data": [],
  "message": "Sorry, your check cannot be processed at the moment. Please try again in a few minutes"
}
```

### 401 Unauthorized

```json theme={null}
{
  "status": "failed",
  "message": "Authentication credentials were not provided."
}
```


## OpenAPI

````yaml GET /api/v1/monitoring/kyc_search/
openapi: 3.0.3
info:
  title: Adhere API
  description: >-
    Identity verification, credit checks, transaction monitoring, and loan fraud
    detection across Africa.
  version: 3.0.0
servers:
  - url: https://adhere-api.smartcomply.com
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Nigeria KYC
  - name: Kenya KYC
  - name: Ghana KYC
  - name: Rwanda KYC
  - name: Uganda KYC
  - name: Document Verification
  - name: Biometrics
  - name: Individual Credit
  - name: Business Credit
  - name: Transaction Monitoring
  - name: Transaction Screening
  - name: Transaction KYC
  - name: Loan Fraud
  - name: User Journey
paths:
  /api/v1/monitoring/kyc_search/:
    get:
      tags:
        - Transaction KYC
      summary: Get All KYC Search Results
      operationId: getAllKycResults
      responses:
        '200':
          description: All KYC results retrieved
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  responses:
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: failed
              data:
                type: array
                items: {}
              message:
                type: string
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: failed
              message:
                type: string
                example: Authentication credentials were not provided.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-access-token
      description: Your Adhere API secret key

````