{
  "spec": "agent402-service-manifest/1",
  "version": 1,
  "name": "Fin Codes API",
  "summary": "Pay-per-request banking data API for AI agents: IBAN validation, SWIFT/BIC lookup, bank and branch reference data, Verification of Payee for supported SEPA accounts, and sanctions screening.",
  "homepage": "https://fincodesapi.com",
  "machineReadable": {
    "openapi": "https://api.fincodesapi.com/openapi.json"
  },
  "payment": {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "USDC",
    "asset_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "pay_to": "0xcd0DDf5A922779279927c4CCfD443949C53908D4"
  },
  "resources": [
    {
      "resource": "https://api.fincodesapi.com/x402/bic/lookup",
      "method": "POST",
      "name": "BIC/SWIFT lookup",
      "description": "Look up a BIC/SWIFT using maintained financial-institution reference data. Returns bank, branch, location and country information where available. No account, API key or subscription required; x402 clients handle USDC payment automatically. Requests missing the bic field are rejected with HTTP 400 before payment. Price: $0.04 USDC per request.",
      "price": "$0.04",
      "input_schema": {
        "type": "object",
        "properties": {
          "bic": {
            "description": "8- or 11-character BIC/SWIFT code to validate and look up.",
            "type": "string",
            "example": "SOGEDEFF"
          }
        },
        "required": [
          "bic"
        ]
      }
    },
    {
      "resource": "https://api.fincodesapi.com/x402/iban/lookup",
      "method": "POST",
      "name": "IBAN validation and bank lookup",
      "description": "Validate and look up an IBAN using maintained banking reference data. Returns account structure, country, national bank/branch codes and the associated BIC/SWIFT where available. No account, API key or subscription required; x402 clients handle USDC payment automatically. Requests missing the iban field or containing other fields are rejected with HTTP 400 before payment. Price: $0.04 USDC per request.",
      "price": "$0.04",
      "input_schema": {
        "type": "object",
        "properties": {
          "iban": {
            "description": "International Bank Account Number (IBAN) to validate and look up.",
            "type": "string",
            "example": "DE75512108001245126199"
          }
        },
        "required": [
          "iban"
        ]
      }
    },
    {
      "resource": "https://api.fincodesapi.com/x402/iban/verify-payee",
      "method": "POST",
      "name": "Verification of Payee (VoP)",
      "description": "Verify whether a payee name matches the account holder for a supported SEPA IBAN. Returns MATCH, CLOSE_MATCH, NO_MATCH, NOT_APPLICABLE or BANK_UNAVAILABLE together with IBAN and bank information enriched using maintained banking reference data. No account, API key or subscription required; x402 clients handle USDC payment automatically. Requests missing the iban or payee_name field are rejected with HTTP 400 before payment. Price: $0.20 USDC per request.",
      "price": "$0.20",
      "input_schema": {
        "type": "object",
        "properties": {
          "iban": {
            "description": "SEPA IBAN whose account holder name should be verified.",
            "type": "string",
            "example": "DE75512108001245126199"
          },
          "payee_name": {
            "description": "Expected payee/account-holder name to verify.",
            "type": "string",
            "example": "John Doe"
          }
        },
        "required": [
          "iban",
          "payee_name"
        ]
      }
    },
    {
      "resource": "https://api.fincodesapi.com/x402/sanctions-screening",
      "method": "POST",
      "name": "Sanctions screening - EU, UK, UN, OFAC, Swiss, Australian and Canadian lists",
      "description": "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.",
      "price": "$0.01",
      "input_schema": {
        "type": "object",
        "properties": {
          "name": {
            "description": "Name to screen.",
            "type": "string",
            "example": "Sadam Husein",
            "maxLength": 255,
            "minLength": 2
          },
          "type": {
            "description": "Only match parties of this type.",
            "type": "string",
            "example": "INDIVIDUAL",
            "enum": [
              "INDIVIDUAL",
              "ENTITY",
              "VESSEL",
              "AIRCRAFT"
            ]
          },
          "sources": {
            "description": "Only screen against these sanctions lists. All lists by default.",
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "EU",
                "UK",
                "UN",
                "OFAC_SDN",
                "OFAC_CONS",
                "CH",
                "AU",
                "CA"
              ]
            },
            "example": [
              "EU",
              "OFAC_SDN"
            ]
          },
          "min_score": {
            "description": "Minimum match score from 70 to 100.",
            "type": "integer",
            "example": 90,
            "default": 90,
            "maximum": 100,
            "minimum": 70
          }
        },
        "required": [
          "name"
        ]
      }
    }
  ]
}