---
title: "ISO 20022-to-EVM Calldata Mapper"
method: POST
path: "/v1/tools/map_iso20022_to_evm_calldata"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# ISO 20022-to-EVM Calldata Mapper

`POST /v1/tools/map_iso20022_to_evm_calldata`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/map_iso20022_to_evm_calldata`
- Auth: none declared

Deterministic bind of an ISO 20022 pacs.008 (customer credit transfer) or pacs.009 (FI credit transfer) payment message to EVM contract-call arguments, plus an OCG receipt of the mapping: resolved call, field bindings, unmapped required fields, and ABI type coercions. Draft-pinned generic ISO-20022-to-EVM profile: Swift blockchain-based shared ledger MVP (Besu/EVM-compatible, live 2026-07-09) has not published a field-binding table or a fixed contract ABI shape. Never queries a chain or RPC.

**Tool URL:** https://ainumbers.co/chaingraph/art-288-map-iso20022-to-evm-calldata.html

## Request body

- object
  - `contract_abi_fragment` unknown, required
  - `iso_fields` unknown, required
  - `iso_message_type` unknown, required
  - `mapping_profile` unknown, required

## Response `200`

Successful tool execution result

- object
  - `abi_type_coercions` object[]
    - `abi_input` string
    - `coercion` string
    - `iso_field` string
    - `type` string
  - `draft_pinned` boolean
  - `field_bindings` object[]
    - `abi_input` string
    - `iso_field` string
    - `resolved` boolean
    - `type` string
  - `iso_message_type` string
  - `mapping_ok` boolean
  - `mapping_profile` string
  - `mapping_profile_version` string
  - `resolved_call` object
    - `args` string[]
    - `function` string
  - `unmapped_required_fields` unknown[]
    - unknown
  - `warnings` unknown[]
    - unknown

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)