SWIFT

Payment Pre-validation API

The SWIFT Payment Pre-validation API allows financial institutions and PSPs to verify payment instruction data against reference data and counterparty information before executing a payment. Checks account numbers, country codes, routing information, and beneficiary account validity to reduce failed payments.

GitHub OpenAPI

Operations 10

POST /accounts/verification Verify that a beneficiary account could be able to receive incoming funds #
POST /accounts/data-provider Validates the instructed institution as Payment Pre-validation Data Provider #
POST /payment/account-format Validates the account format #
POST /payment/financial-institution-identity Validates the instructed institution as financial institution #
POST /payment/purpose-code Validates the purpose code #
POST /payment/payment-purpose Validates the payment purpose #
POST /payment/category-purpose Validates the category purpose #
POST /payment/amount Validates the instructed amount #
POST /payment/eligibility-check Verify the payment for Rulebook eligibility and obtain payment predictability #
POST /payment/payment-instruction Validates the payment instruction #

Documentation

📖
Documentation
https://developer.swift.com/apis/payment-pre-validation-api

Specifications

⚙
OpenAPI
https://artifacts.apis.io/swift/openapi/swift-payment-pre-validation-api-openapi.yml
⚙
OpenAPI
https://raw.githubusercontent.com/swiftinc/api-sample-code/main/java/spring-boot/preval/src/main/openapi/SWIFT-API-payment-validation-2.4.1-resolved-2.yaml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/swift/json-schema/swift-payment-instruction-schema.json
📊
JSONSchema
https://artifacts.apis.io/swift/json-schema/swift-payment-instruction-validation-schema.json
📊
JSONSchema
https://artifacts.apis.io/swift/json-schema/swift-payment-purpose-validation-status1-schema.json
📊
JSONSchema
https://artifacts.apis.io/swift/json-schema/swift-eligibility-check-status1-schema.json
📊
JSONSchema
https://artifacts.apis.io/swift/json-schema/swift-account-verification-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/swift/json-schema/swift-account-format-validation-status1-schema.json

Other Resources

🔗
ProductPage
https://www.swift.com/products/payment-pre-validation
🔗
APIsJSON
https://artifacts.apis.io/swift/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/swift:payment-pre-validation-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

swift-payment-pre-validation-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Payment Pre-validation API
  description: 'Enable your application to validate your cross-border payment instructions as early as possible in the payment process.


    **v2.4.1 Release Notes**


    As part of the continuous development of Payment Pre-validation API services, a new validation service is available as below. In addition, there are some minor changes to the descriptions and examples for the other existing services to align with the functional specification document.


    **Payment Instruction validation service** - This service provides a contextual payment validation. It is meant for a debtor bank or payment initiating end-customer who wants to validate a combination of payment elements, and that with one single API:

    * Debtor Agent Country

    * Creditor Agent Country

    * Creditor Account

    * Instructed Currency, and

    * Instructed Amount


    Based on the elements provided, the service orchestrates multiple validations (note that these validations remain as well available as individual services). This contextual validation service is designed as such, that new validations of additional elements can easily be integrated in the future.


    Further to this new validation service, updates have been made to the error response examples with the updated internal error codes.'
  contact:
    name: Standards & Developer Hub
    url: https://developer.swift.com
    email: developer-support@swift.com
  license:
    name: API Restricted License
    url: https://www.swift.com/file/56776/download?token=8w8DC4eF
  version: 2.4.1
servers:
- url: https://api-test.swiftnet.sipn.swift.com/swift-preval-pilot/v2
  description: URL for Apigee (SDK consumer) Pilot.
- url: https://api.swiftnet.sipn.swift.com/swift-preval/v2
  description: URL for Apigee (SDK consumer) Live.
- url: https://sandbox.swift.com/swift-preval/v2
  description: URL for Sandbox Environment.
- url: https://api.swift.com/swift-preval/v2
  description: URL for Production Environment
- url: https://api-pilot.swift.com/swift-preval-pilot/v2
  description: URL for Test Environment
security:
- oauthBearerToken: []
tags:


# --- truncated at 32 KB (294 KB total) ---
# Full source: https://artifacts.apis.io/swift/openapi/swift-payment-pre-validation-api-openapi.yml