Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

KeyBank Wire Transfer API

The Wire Transfer API, delivered through KeyBank's combined RTP and Wire Payments service, facilitates high-value domestic wire payments from commercial accounts. It provides operations to initiate a payment, validate payment details before submission, and look up RTP/wire network participants by routing number. Requests are authenticated with OAuth2 bearer tokens and mutual TLS client certificates and carry an x-fapi-interaction-id header; production runs on https://partner-api.key.com with a QV sandbox.

KeyBank Wire Transfer API is one of 10 APIs that KeyCorp publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Payments, Wire Transfer, Commercial Banking, and United States. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 5 paths, organized into 4 resource areas, and defines 13 schemas. It is described by OpenAPI 3.0.2, at version 1.3.3.

Requests are made against 2 base URLs: https://partner-api-qv.key.com, https://partner-api.key.com.

5 operations 5 paths 13 schemas 3 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.2
API Version
1.3.3
Base URL
https://partner-api.key.com/rtp/v1/payment
Authentication
HTTP Bearer
Resource Areas
4

Authentication & Security 1

KeyBank Wire Transfer API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth).

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 3 GET, 2 POST. They span 4 resource areas: HealthCheck, Initiate, Participant, Validate. Each is listed below with its method, path, parameters, and response codes.

HealthCheck 1

Verify you can connect to the API service. A bearer token is required.

GET
/rtp/v1/payment/healthCheck
Health check
healthCheckv1 → 200
Initiate 1

Send a payment.

POST
/rtp/v1/payment/initiate
Send a real-time payment or a wire transfer
Payment-Initiate 1 param body → 200400401403404405415429
Participant 2

Look up a RTP participating banks.

GET
/rtp/v1/payment/rtp/participant
Get a list of RTP participants
participantList 3 params → 200400401403404405415429
GET
/rtp/v1/payment/rtp/participant/{routingNumber}
Get information about one RTP participant
participant 2 params → 200400401403404405415429
Validate 1

Perform validation checks for a payment transaction.

POST
/rtp/v1/payment/validate
Perform validation checks
Payment-Validate 1 param body → 200400401403404405415429

Schemas 13

The contract defines 13 schemas that model the data the API accepts and returns. The most detailed are paymentTransactionRequestV1 (21 properties), paymentTransactionResponse (13 properties), serviceErrorData (10 properties), party (7 properties). Each schema is shown below with its type and property counts.

healthResponse
object
The response for a successful API health check.
5 properties
exception
object
Contains information about the errors related to the request.
5 properties
serviceErrorData
object
The service error returns the same response payload as a successful response with additional details specific to the error.
10 properties 1 required
connectError
object
1 property
paymentTransactionRequestV1
object
Contains the request body for payment initiation or validation.
21 properties 10 required
party
object
Details about the parties involved in the transaction.
7 properties 1 required
participantListResponse
object
Contains the response body for RTP participant inquiries.
4 properties 3 required
foreignBankSystemType
object
2 properties
paymentTransactionResponse
object
Contains the response body with payment transaction details.
13 properties 1 required
paymentStatus
string
The status of the payment transaction. Valid values: INPROCESS, INREVIEW, COMPLETED, FAILED, RETURNED, ERROR, VALID
paymentError
object
Error messages related to the API and backend services.
4 properties 2 required
noYesType
string
This field indicates whether the transaction qualifies for Dodd-Frank.
ultParty
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

keycorp-rtp-wire-payments-openapi.yml Raw ↑

Other APIs KeyCorp publishes across the network.

KeyBank Account Information API
KeyBank ACH Origination API
KeyBank RTP Send Payment API
KeyBank Account Validation API
KeyBank ACH Inquiry API
KeyBank Wire Inquiry API
KeyBank RTP Inquiry API
KeyBank Check Services API
KeyBank Webhooks