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 Check Services API

The Check Services API manages stop payments and check image retrieval for commercial KeyBank accounts. It exposes operations to place a stop payment, list and retrieve check images, and a health check, letting treasury and accounts-payable teams control and audit paper and electronic check activity programmatically. Authenticated with OAuth2 bearer tokens and mutual TLS client certificates over https://partner-api.key.com, with a QV sandbox environment for integration testing.

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

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

This API exposes 3 operations across 3 paths, organized into 3 resource areas, and defines 12 schemas. It is described by OpenAPI 3.1.0, at version 1.1.1.

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

3 operations 3 paths 12 schemas 1 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.1.1
Base URL
https://partner-api.key.com/commercial/checks/v1
Authentication
HTTP Bearer
Resource Areas
3

Authentication & Security 1

KeyBank Check Services API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Access token supplied in the Authorization header using the Bearer scheme (e.g. Authorization: Bearer {token}).

Paths & Operations 3

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

StopPayments 1

Place new stop payments

POST
/commercial/checks/v1/stops/place
Place a stop payment
PlaceStopPayments 1 param body → 200202400401403404405409
ImageCheck 1

List check images

POST
/commercial/checks/v1/images/list
List of check images
CheckImageListRequest 1 param body → 200400401403404405415429
HealthCheck 1

Verify you can connect to the API service.

GET
/commercial/checks/v1/healthCheck
Health check
healthCheck → 200

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are CheckImage (9 properties), StopPayments (8 properties), StopPaymentPlaceRequest (6 properties), Exception (6 properties). Each schema is shown below with its type and property counts.

HealthResponse
object
5 properties
StopPaymentPlaceRequest
object
Request to place a stop payment on an account.
6 properties 2 required
CheckImageListRequest
object
Request to retrieve check image records for an account.
5 properties 3 required
StopPaymentPlaceResponse
object
Successful response to place a stop payment.
1 property
CheckImageListResponse
object
Check Image list response.
1 property
ResponseMetadata
object
Error metadata including validation or service messages.
1 property
Message
object
Field-level error or informational message.
2 properties
StopPayments
object
Stop payment record.
8 properties
CheckImage
object
Check image record.
9 properties
Exception
object
Contains information about errors related to the request.
6 properties
ServiceErrorData
object
Detailed service-level error information, if available.
1 property
ConnectError
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

keycorp-check-services-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 Account Validation API
KeyBank ACH Inquiry API
KeyBank Wire Inquiry API
KeyBank RTP Inquiry API
KeyBank Webhooks