---
title: "DTC Corporate Actions ISO 20022 Message Validator"
method: POST
path: "/v1/tools/validate_dtcc_ca_iso20022_message"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# DTC Corporate Actions ISO 20022 Message Validator

`POST /v1/tools/validate_dtcc_ca_iso20022_message`

## Request

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

Validates the structural message-shape of a single DTC corporate-action event message (notification / election / allocation) against the ISO 20022 field set migrated under DTCC Important Notice 23890-26 (legacy corporate-actions message format decommission -- a DTCC operator mandate, not a regulatory deadline: PSE testing 2026-01, Test Facility 2026-03, PROD testing 2026-07, legacy decommission Q3 2027). Checks required-field presence per message function, ISO 20022 CAEV event-type code, CUSIP format, DTC participant number, and date formats. Message-shape validation only -- does NOT compute entitlement, dividend, rights, or split amounts; that half is corporate-action entitlement recompute (art-547), which chains from this node's output.

**Tool URL:** https://ainumbers.co/chaingraph/art-546-dtcc-ca-iso20022-validator.html

## Request body

- object
  - `allocated_quantity` unknown, required
  - `allocation_date` unknown, required
  - `cusip` unknown, required
  - `dtc_participant_number` unknown, required
  - `election_deadline` unknown, required
  - `election_option` unknown, required
  - `event_type` unknown, required
  - `message_function` unknown, required
  - `payable_date` unknown, required
  - `record_date` unknown, required
  - `reference_id` unknown, required

## Response `200`

Successful tool execution result

- object
  - `disambiguation` string
  - `dtcc_operator_mandate_basis` string
  - `error_count` integer
  - `event_type` string
  - `message_function` string
  - `not_legal_advice` string
  - `pii_note` string
  - `readiness_pct` integer
  - `reference_id` string
  - `structure_valid` boolean
  - `table_source` string
  - `table_version` string
  - `violations` 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)