---
title: "ISO 20022 Purpose Code Requirement Checker"
method: POST
path: "/v1/tools/check_purpose_code_requirement"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# ISO 20022 Purpose Code Requirement Checker

`POST /v1/tools/check_purpose_code_requirement`

## Request

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

Given a beneficiary country and payment amount, determines whether ExternalPurpose1Code (Purp/Cd) or ExternalCategoryPurpose1Code (CtgyPurp/Cd) is mandatory per BIS CPMI d218 jurisdiction profiles (UAE, India, Bahrain, Jordan, China, Malaysia mandate purpose codes). Also checks SwiftGo eligibility (amount at most $12,500 USD and ExternalCategoryPurpose1Code in accepted set). Outputs purpose_code_compliant, code_type_required, and swiftgo_eligible.

**Tool URL:** https://ainumbers.co/chaingraph/art-243-purpose-code-requirement-checker.html

## Request body

- object
  - `beneficiary_country` unknown, required
  - `category_purpose_code` unknown, required
  - `payment_amount_usd` number, required: Amount in US dollars
  - `purpose_code` unknown, required

## Response `200`

Successful tool execution result

- object
  - `category_purpose_code_provided` boolean
  - `code_type_required` string
  - `issues` unknown[]
    - unknown
  - `jurisdiction_reason` string
  - `jurisdiction_requires_purpose_code` boolean
  - `pii_note` string
  - `purpose_code_compliant` boolean
  - `purpose_code_provided` boolean
  - `purpose_format_valid` boolean
  - `regulatory_basis` string
  - `required_code_types` string[]
  - `swiftgo_accepted_category_codes` string[]
  - `swiftgo_amount_ok` boolean
  - `swiftgo_category_ok` boolean
  - `swiftgo_eligible` boolean
  - `swiftgo_max_usd` integer
  - `swiftgo_notes` unknown[]
    - unknown
  - `table_source` string
  - `table_version` string

---

[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)