# Criblage public sanctions par nom

Crible un nom dans les listes publiques françaises, britanniques et ONU intégrées avec rapprochement textuel explicable.

## Endpoint

- Méthode: `POST`
- URL: `https://api.helpmyagent.com/v1/compliance/name-screen`
- Prix: `0.020 USD` / call

## Découverte machine

- llms.txt: https://helpmyagent.com/llms.txt
- OpenAPI 3.1: https://api.helpmyagent.com/openapi.json
- capabilities.json: https://helpmyagent.com/capabilities.json
- MCP: https://helpmyagent.com/mcp
- RFC 9727: https://helpmyagent.com/.well-known/api-catalog
- pricing.json: https://helpmyagent.com/pricing.json
- x402: https://helpmyagent.com/.well-known/x402
- x402-service.json: https://helpmyagent.com/.well-known/x402-service.json
- Health status: https://helpmyagent.com/health

## x402 payment methods

- USDC on `eip155:8453`
- RLUSD on `xrpl:0`

## Couverture

FR, GB, UN

## À utiliser quand

- Contrôler un nom de personne ou d’organisation dans des listes publiques de sanctions.

## À éviter quand

- Utilisez une API plus spécialisée si vous n’avez besoin que d’une donnée élémentaire déjà disponible.

## Limites

- Les résultats dépendent de la disponibilité et du périmètre des sources publiques citées.

## Exemples de demandes

- Contrôler un nom de personne ou d’organisation dans des listes publiques de sanctions.

## Fraîcheur

```json
{
    "mode": "source_dependent"
}
```

## Sources

- [French, UK and UN public sanctions lists](https://gels-avoirs.dgtresor.gouv.fr)

## Schéma d’entrée

```json
{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "minLength": 2,
            "maxLength": 200,
            "description": "Nom de personne ou d’organisation comparé aux listes publiques de sanctions et de gel des avoirs prises en charge. (longueur minimale 2; longueur maximale 200)."
        },
        "threshold": {
            "type": "integer",
            "minimum": 50,
            "maximum": 100,
            "default": 85,
            "description": "Score minimal de rapprochement flou accepté comme correspondance candidate dans une liste publique. (minimum 50; maximum 100; valeur par défaut 85)."
        }
    },
    "additionalProperties": false,
    "required": [
        "name"
    ],
    "description": "Paramètres structurés de l’API compliance/name-screen."
}
```

## Schéma de sortie

```json
{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "description": "Nom public de l’entreprise, personne, acheteur ou enregistrement concerné."
        },
        "threshold": {
            "type": "integer",
            "description": "Valeur structurée retournée pour « threshold » selon le contrat de cette API."
        },
        "status": {
            "type": "string",
            "description": "Statut normalisé de l’API ou de la source."
        },
        "match_count": {
            "type": "integer",
            "description": "Nombre de correspondances candidates retournées par le contrôle."
        },
        "matches": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "source": {
                        "type": "string",
                        "description": "Valeur structurée retournée pour « source » selon le contrat de cette API."
                    },
                    "name": {
                        "type": "string",
                        "description": "Nom public de l’entreprise, personne, acheteur ou enregistrement concerné."
                    },
                    "score": {
                        "type": "integer",
                        "description": "Score normalisé produit par l’API ; son interprétation est définie par la description et les limites du tool."
                    },
                    "reference": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Valeur structurée retournée pour « reference » selon le contrat de cette API."
                    },
                    "type": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Valeur structurée retournée pour « type » selon le contrat de cette API."
                    }
                },
                "additionalProperties": false,
                "required": [
                    "source",
                    "name",
                    "score",
                    "reference",
                    "type"
                ]
            },
            "description": "Correspondances candidates retournées depuis les listes ou sources publiques."
        },
        "sources": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "source": {
                        "type": "string",
                        "description": "Valeur structurée retournée pour « source » selon le contrat de cette API."
                    },
                    "status": {
                        "type": "string",
                        "description": "Statut normalisé de l’API ou de la source."
                    },
                    "records_scanned": {
                        "type": "integer",
                        "description": "Valeur structurée retournée pour « records scanned » selon le contrat de cette API."
                    },
                    "publication_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Valeur structurée retournée pour « publication date » selon le contrat de cette API."
                    }
                },
                "additionalProperties": false,
                "required": [
                    "source",
                    "status",
                    "records_scanned",
                    "publication_date"
                ]
            },
            "description": "Sources de données publiques utilisées ou contrôlées pour ce résultat."
        },
        "checked_at": {
            "type": "string",
            "description": "Horodatage UTC du contrôle effectué par HelpMyAgent."
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Limites connues d’interprétation, de couverture ou de fraîcheur de ce résultat."
        }
    },
    "additionalProperties": false,
    "required": [
        "name",
        "threshold",
        "status",
        "match_count",
        "matches",
        "sources",
        "checked_at"
    ],
    "description": "Résultat structuré retourné par l’API compliance/name-screen."
}
```

## Instantané de démonstration

Cet exemple est un instantané stocké en base de données et ne déclenche aucun appel API en direct.
- URL: https://api.helpmyagent.com/demo/compliance/name-screen
- Généré le: 2026-09-07T14:49:59+00:00

## Exemple de requête

```json
{
    "name": "LA POSTE",
    "threshold": 90
}
```

## Exemple de réponse stocké

```json
{
    "name": "LA POSTE",
    "threshold": 90,
    "status": "PARTIAL_UNAVAILABLE",
    "match_count": 0,
    "matches": [],
    "sources": [
        {
            "source": "FR_ASSET_FREEZE",
            "status": "ok",
            "records_scanned": 16425,
            "publication_date": null
        },
        {
            "source": "UK_SANCTIONS",
            "status": "unavailable",
            "records_scanned": 0,
            "publication_date": null
        },
        {
            "source": "UN_CONSOLIDATED",
            "status": "unavailable",
            "records_scanned": 0,
            "publication_date": null
        }
    ],
    "checked_at": "2026-09-07T16:49:59+02:00",
    "limitations": [
        "Le rapprochement est textuel et peut produire des faux positifs ou faux négatifs ; un résultat potentiel doit être revu humainement.",
        "L’absence de correspondance ne constitue pas une garantie AML/sanctions."
    ]
}
```

## Règles de facturation

```json
{
    "charge_on": "valid_result",
    "no_charge_on_empty_result": true,
    "no_charge_on_error": true
}
```