SWIFT MT Message Type

GET/v0/swift-mt

Validates a SWIFT MT message type (e.g. MT103, MT202, MT940). Input can be provided with or without the MT prefix and is case-insensitive. Returns the message category, group, and description.

Guides: Node.js · Python

Try it

Query Parameters

ParameterTypeRequiredDescription
valuestringYesSWIFT MT message type (e.g. MT103, 202, mt940)

Example Requests

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/swift-mt?value=MT103"

Response Fields

FieldTypeDescription
validbooleanWhether the value is a recognised SWIFT MT message type
typestringNormalised message type (e.g. MT103, MT202COV)
categorynumberCategory number (0–9)
groupstringCategory group name (e.g. Customer Payments & Cheques, Securities Markets)
descriptionstringHuman-readable description of the message type

Example Response

{
  "valid": true,
  "type": "MT103",
  "category": 1,
  "group": "Customer Payments & Cheques",
  "description": "Single Customer Credit Transfer"
}

Example Response — invalid

{
  "valid": false
}
GET/v0/swift-mt/list

Returns the complete list of SWIFT MT message types. Optionally filter by category number.

Query Parameters

ParameterTypeRequiredDescription
categorynumberNoFilter by category (0–9), e.g. 1 for Customer Payments, 5 for Securities Markets

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/swift-mt/list?category=1"

Object Fields

FieldTypeDescription
typestringSWIFT MT message type
categorynumberCategory number (0–9)
groupstringCategory group name
descriptionstringMessage description

Example Response

[
  { "type": "MT101", "category": 1, "group": "Customer Payments & Cheques", "description": "Request for Transfer" },
  { "type": "MT103", "category": 1, "group": "Customer Payments & Cheques", "description": "Single Customer Credit Transfer" },
  { "type": "MT104", "category": 1, "group": "Customer Payments & Cheques", "description": "Direct Debit and Request for Debit Transfer" },
  ...
]