Fin Codes API
Screen a person, entity, vessel or aircraft name against the EU, UK, UN, OFAC (SDN and Consolidated), Swiss, Australian and Canadian sanctions lists, refreshed daily. Returns the matching sanctioned parties with match scores, programs, birth dates and list references, best match first; matches are name similarity and should be reviewed. No account, API key or subscription required; x402 clients handle USDC payment automatically. Requests missing the name field or containing other fields are rejected with HTTP 400 before payment. Price: $0.01 USDC per request.
Offering
- Provider
- api.fincodesapi.com
- Method
- POST
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Legal And Compliance
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://api.fincodesapi.com/x402/sanctions-screening- MIME type
- application/json
- First seen
- 2026-10-16T02:06:24.291Z
- Last seen
- Tags
- sanctions, sanctions-screening, compliance, aml, KYC
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"payTo": "0xcd0DDf5A922779279927c4CCfD443949C53908D4"
}
]Observed health
- Status
- Healthy
- Latest latency
- 231 ms
- Average latency
- 345 ms
- HTTP status
- 204
- Last checked
- Reachability
- 100% over 14 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"body": {
"name": "Sadam Husein",
"type": "INDIVIDUAL",
"sources": [
"EU",
"OFAC_SDN"
],
"min_score": 90
},
"type": "http",
"method": "POST",
"bodyType": "json"
}Output schema
{
"type": "object",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"body",
"bodyType"
],
"properties": {
"body": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"example": "Sadam Husein",
"maxLength": 255,
"minLength": 2,
"description": "Name to screen."
},
"type": {
"enum": [
"INDIVIDUAL",
"ENTITY",
"VESSEL",
"AIRCRAFT"
],
"type": "string",
"example": "INDIVIDUAL",
"description": "Only match parties of this type."
},
"sources": {
"type": "array",
"items": {
"enum": [
"EU",
"UK",
"UN",
"OFAC_SDN",
"OFAC_CONS",
"CH",
"AU",
"CA"
],
"type": "string"
},
"example": [
"EU",
"OFAC_SDN"
],
"description": "Only screen against these sanctions lists. All lists by default."
},
"min_score": {
"type": "integer",
"default": 90,
"example": 90,
"maximum": 100,
"minimum": 70,
"description": "Minimum match score from 70 to 100."
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"type": "string",
"const": "POST"
},
"bodyType": {
"type": "string",
"const": "json"
}
}
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"const": "json"
},
"example": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "Sadam Husein",
"description": "Screened name"
},
"matches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"example": "ef947777-8b4c-4859-b07b-042be956bf4a",
"description": "Sanctioned party ID"
},
"name": {
"type": "string",
"example": "Saddam Hussein Al-Tikriti",
"description": "Primary name of the party"
},
"type": {
"enum": [
"INDIVIDUAL",
"ENTITY",
"VESSEL",
"AIRCRAFT"
],
"type": "string",
"example": "INDIVIDUAL",
"description": "Party type"
},
"score": {
"type": "integer",
"example": 90,
"description": "Match score from 0 to 100"
},
"source": {
"enum": [
"EU",
"UK",
"UN",
"OFAC_SDN",
"OFAC_CONS",
"CH",
"AU",
"CA"
],
"type": "string",
"example": "EU",
"description": "Sanctions list code"
},
"programs": {
"type": "array",
"items": {
"type": "string"
},
"example": [
"IRQ"
],
"description": "Sanctions programs or regimes"
},
"listed_on": {
"type": [
"string",
"null"
],
"format": "date",
"example": "2003-07-08",
"description": "Date the party was listed"
},
"birth_dates": {
"type": "array",
"items": {
"type": "string"
},
"example": [
"1937-04-28"
],
"description": "Known birth dates: YYYY, YYYY-MM or YYYY-MM-DD"
},
"matched_name": {
"type": "string",
"example": "Saddam Hussein Al-Tikriti",
"description": "Name or alias of the party that matched"
},
"source_reference": {
"type": "string",
"example": "EU.27.28",
"description": "Reference of the party in the sanctions list"
}
}
},
"description": "Matching sanctioned parties, best match first. Empty if the name matches no sanctioned party"
}
}
},
"success": {
"type": "boolean",
"example": true,
"description": "Success"
}
}
}
}
}
}
}