# Public Sanctions Name Screen

Screens a name against integrated French, UK and UN public sanctions/freezing lists using explainable fuzzy matching.

## Endpoint

- Method: `POST`
- URL: `https://api.helpmyagent.com/v1/compliance/name-screen`
- Price: `0.020 USD` / call

## Machine discovery

- 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`

## Coverage

FR, GB, UN

## Use when

- Screen a person or organization name against public sanctions lists.
- You have a person or organization name and need explainable screening against the supported French, UK and UN public sanctions lists.
- You need candidate matches with fuzzy-match scores before manual review.

## Avoid when

- You have a French company identifier and want company-aware public compliance checks; use company/fr/compliance.
- You need a complete commercial AML/KYC database or a legal guarantee that a subject is unsanctioned.

## Limitations

- Fuzzy name matching can produce false positives and false negatives, especially for aliases, transliteration and common names.
- No match means only that no candidate was found in the supported public lists at check time.

## Example queries

- Screen a person or organization name against public sanctions lists.

## Freshness

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

## Sources

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

## Input schema

```json
{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "minLength": 2,
            "maxLength": 200,
            "description": "Person or organization name to compare with the supported public sanctions and asset-freeze lists. (minimum length 2; maximum length 200)."
        },
        "threshold": {
            "type": "integer",
            "minimum": 50,
            "maximum": 100,
            "default": 85,
            "description": "Minimum fuzzy-match score accepted as a candidate public-list match. (minimum 50; maximum 100; default 85)."
        }
    },
    "additionalProperties": false,
    "required": [
        "name"
    ],
    "description": "Structured input parameters for the compliance/name-screen API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "description": "Publicly available company, person, buyer or record name for this result."
        },
        "threshold": {
            "type": "integer",
            "description": "Structured value returned for “threshold” as defined by this API contract."
        },
        "status": {
            "type": "string",
            "description": "Normalized endpoint or source status."
        },
        "match_count": {
            "type": "integer",
            "description": "Number of candidate matches returned by the screening operation."
        },
        "matches": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "source": {
                        "type": "string",
                        "description": "Structured value returned for “source” as defined by this API contract."
                    },
                    "name": {
                        "type": "string",
                        "description": "Publicly available company, person, buyer or record name for this result."
                    },
                    "score": {
                        "type": "integer",
                        "description": "Normalized score produced by the endpoint; interpretation is defined by the tool description and limitations."
                    },
                    "reference": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “reference” as defined by this API contract."
                    },
                    "type": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “type” as defined by this API contract."
                    }
                },
                "additionalProperties": false,
                "required": [
                    "source",
                    "name",
                    "score",
                    "reference",
                    "type"
                ]
            },
            "description": "Candidate public-list or source matches returned by the endpoint."
        },
        "sources": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "source": {
                        "type": "string",
                        "description": "Structured value returned for “source” as defined by this API contract."
                    },
                    "status": {
                        "type": "string",
                        "description": "Normalized endpoint or source status."
                    },
                    "records_scanned": {
                        "type": "integer",
                        "description": "Structured value returned for “records scanned” as defined by this API contract."
                    },
                    "publication_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “publication date” as defined by this API contract."
                    }
                },
                "additionalProperties": false,
                "required": [
                    "source",
                    "status",
                    "records_scanned",
                    "publication_date"
                ]
            },
            "description": "Public data sources used or checked for this result."
        },
        "checked_at": {
            "type": "string",
            "description": "UTC timestamp at which HelpMyAgent performed the check."
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Known interpretation, source-coverage or freshness limitations for this result."
        }
    },
    "additionalProperties": false,
    "required": [
        "name",
        "threshold",
        "status",
        "match_count",
        "matches",
        "sources",
        "checked_at"
    ],
    "description": "Structured result returned by the compliance/name-screen API."
}
```

## Demonstration snapshot

This example is a database-stored snapshot and does not execute the live API.
- URL: https://api.helpmyagent.com/demo/compliance/name-screen
- Generated at: 2026-09-07T14:49:59+00:00

## Request example

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

## Stored response example

```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."
    ]
}
```

## Billing policy

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