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 Account Validation API

The Account Validation v2 API verifies account details and ownership before commercial payments and transfers are initiated, matching the supplied account and owner information against the National Shared Database Resource, the financial industry's collaborative source of account status data. It exposes a verifyAccount operation plus a health check, and requires a KeyBank-issued secondaryId in addition to OAuth2 bearer tokens and client certificates. Base host is https://partner-api.key.com with a QV sandbox.

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

Tagged areas include Account Validation, Payments, Fraud Prevention, and United States. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 2 operations across 2 paths, organized into 2 resource areas, and defines 20 schemas. It is described by OpenAPI 3.0.1, at version 2.0.4.

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

2 operations 2 paths 20 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2.0.4
Base URL
https://partner-api.key.com/accounts/validations/v2
Authentication
HTTP Bearer
Resource Areas
2

Authentication & Security 1

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

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 1 GET, 1 POST. They span 2 resource areas: HealthCheck, Operations. Each is listed below with its method, path, parameters, and response codes.

HealthCheck 1
GET
/accounts/validations/v2/healthCheck
Health check
healthCheck → 200
Operations 1
POST
/accounts/validations/v2/verifyAccount
Verify an account
verifyAccount body → 200400401403404415429500

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are AcctOwner_1 (20 properties), AcctOwner (18 properties), Result (11 properties), Inquiry (7 properties). Each schema is shown below with its type and property counts.

healthResponse
object
5 properties
exception
object
6 properties
connectError
object
1 property
serviceErrorData
object
1 property
accountValidationV2Request
object
1 property
Inquiry
object
Contains the account inquiry request fields
7 properties 4 required
AOARequest
object
Contains the request payload for the account validation endpoint.
1 property
AOAResponse
object
Contains the response payload for the account validation endpoint.
1 property
errorResponse
object
Error response with related business or system fault related information.
2 properties
AcctOwner_1
object
20 properties
Result
object
Contains the response results for the account owner inquiry
11 properties
systemFault
object
1 property
AcctStatus
object
Contains the account status details.
2 properties
accountValidation_POST_bodyParameters
object
1 property 1 required
businessFault
object
1 property
Client
object
Contains the client-provided date, time, and description of the inquiry request.
3 properties
accountValidation_POST_response
object
1 property 1 required
accountValidationV2Response
object
2 properties 1 required
Client_1
object
Contains the client-provided date, time, and description of the inquiry request.
3 properties
AcctOwner
object
Contains details about the account owner to for a more advanced inquiry.
18 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

keycorp-account-validation-openapi.yml Raw ↑

Other APIs KeyCorp publishes across the network.

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