Look up the status and details about a wire transaction Retrieve the status and details of a wire transaction. Wire Inquiry Endpoints SummaryEndpointHealth checkget /v1/wire/healthCheckSearch wire transferspost /v1/wire/transactions/listView the details of a wire transfer by the transaction ID.get /v1/wire/detail/{transactionId} Health check get /v1/wire/healthCheckVerify you can connect to the API service. A bearer token is required.ResponsesSuccessful responseNAMETYPEDESCRIPTIONStatusstringStatus of the health check response.SourcestringThe origin of the system response can be 'Gateway' or 'Roundtrip'. Roundtrip returns a response from the farthest system involved.TimestampstringThe date (YYYY-MM-DD) and time (HH:MM:SS) of the response from the API service.ClientIpstringThe client IP address the gateway gets from the request.X-Forwarded-ForstringThe sequence of all the IP addresses for systems involved between the client and the gateway.Response example (200){ "Status": "Ok", "Source": "Roundtrip", "Timestamp": "2022-09-15T04:49:03", "ClientIp": "156.77.111.28", "X-Forwarded-For": "[156.77.111.28]" } Search wire transfers post /wire/v1/transactions/listBased on search criteria provided, get a list of wire transfers. The account number and date range are required for every request.RequestNAMETYPEDESCRIPTIONaccountNumberrequiredstringThe bank account number. This field cannot exceed 16 characters.fromDaterequiredstringStart date for the date range. This date can be the current day or within 100 days prior to the current date. To search for a single date, this value will be the same as the toDate. Format: YYYY-MM-DDtoDaterequiredstringEnd date for the date range. This date must be the same or later than the start date (fromDate). To search for a single date, this value will be the same as the fromDate. To search for a range of dates, make sure the date range does not exceed 31 days. Format: YYYY-MM-DDminimumAmountoptionalstringThe minimum dollar amount of the transaction. This amount must be less than or equal to the maximum amount. Leave blank or enter zero for no minimum amount.maximumAmountoptionalstringThe maximum dollar amount of the transaction. This amount must be greater than or equal to the minimum amount. Leave blank to retrieve all amounts. This amount cannot exceed one billion dollars.requestReferencestringA reference value for the original request that is useful for traceability and reporting. The ID cannot exceed 35 characters.pageNumberoptionalstringThe number of the page being viewed. This number must be greater than or equal to 1.pageSizeoptionalstringThe total number of pages returned. This number must be greater than or equal to 1 and cannot exceed 1000.Request example{ "accountNumber": "3123456789", "fromDate": "2024-02-01", "toDate": "2024-02-01", "minimumAmount": "100.00", "maximumAmount": "75020.5", "requestReference": "USt41001030ii016002", "pageNumber": "1", "pageSize": "500" }ResponsesSearch results match the criteriaNAMETYPEDESCRIPTIONtransactionsarrayRtpListTransactionmetadataobjectMetadataResponse example (200){ "transactions": [ { "transactionId": "US99999000999999", "transactionStatus": "COMPLETED", "transactionDate": "2024-02-01", "transactionAmount": 32772.63, "requestReference": "1122334455", "sendersReference": "US99999000999999", "creditor": { "name": "Global Markets LLC" }, "creditorAccount": { "accountNumber": "987654321" }, "debtor": { "name": "Paul Wilson" }, "debtorAccount": { "accountNumber": "123456789" } }], "metadata": { "page": { "pageNumber": 1, "pageSize": 25, "totalPages": 3, "totalRecords": 75, "lastPage": true } } }Bad input parameterNAMETYPEDESCRIPTIONmessagesoptionalarrayMessagepageobjectPageResponse example (400){ "messages": { "code": "Wire-List-400-bad-input", "message": "Bad input parameter" } } View the details of a wire transfer by the transaction ID get /v1/wire/detail/{transactionId}Provide the transaction ID to retrieve all available fields for the wire transfer.Requestpath FIELDTYPEDESCRIPTIONtransactionIdrequiredstringThe unique ID number associated with the original payment request.Request examplecurl --location: 'https://partner-api.keybank.com/v1/rtp/wire/detail/US99999000999999' --header 'KeyClientId: testwUhSQADUD4DwYyZz2hZkwLqsoFGK' --header 'Accept: application/json' --header 'Bearer testZcKJDWnwDWmmf9qah6PJvPy8' ResponsesA Wire transaction matches the provided transactionIdNAMETYPEDESCRIPTIONtransactionIdstringThe unique ID number associated with the original payment request.transactionStatusenumThe status of the RTP payment. Valid values: CANCELLED, COMPLETED, FAILED, IN PROCESS, IN REVIEW, RETURNEDtransactionDatestringDate the transfer occurred. Format: YYYY-MM-DDtransactionAmountnumberThe dollar amount of the transaction.requestReferencestringA reference value for the original request that is useful for traceability and reporting. The ID cannot exceed 35 characters.sendersReferencestringA reference value provided by the sender. For outbound payments, this value is the same as the transaction ID. The ID cannot exceed 35 characters.creditorobjectPartyListcreditorAccountobjectAccountListdebtorobjectPartyListdebtorAccountobjectAccountListoriginatorobjectPartyListoriginatorAccountobjectAccountListbeneficiaryobjectPartyListbeneficiaryAccountobjectAccountListultimateCreditorobjectPartyListultimateCreditorAccountobjectAccountListultimateDebtorobjectPartyListultimateDebtorAccountobjectAccountListremittanceInformationstringSpecific details associated with a transaction like an invoice number or customer details that provide a reason for the payment.Response example (200){ "transactionId": "US99999000999999", "transactionStatus": "COMPLETED", "transactionDate": "2024-02-01", "transactionAmount": 32772.63, "requestReference": "1122334455", "sendersReference": "US99999000999999", "creditor": { "name": "Global Markets LLC" }, "creditorAccount": { "accountNumber": "987654321" }, "debtor": { "name": "Paul Wilson" }, "debtorAccount": { "accountNumber": "123456789" }, "remittanceInformation": "Payment 02/01/2024_Invoice - 123456789 Cust", "originator": { "name": "Global Markets" }, "originatorAccount": { "accountNumber": "987654321", "virtualAccountNumber": "400100225000" }, "beneficiary": { "name": "Wilson" "beneficiaryAccount": { "accountNumber": "123456789", "virtualAccountNumber": "400100338001" } } }No Wire transaction was found with the provided transactionId.NAMETYPEDESCRIPTIONmessagesoptionalarrayMessagepageobjectPageResponse example (404){ "messages": { "code": "Wire-Detail-404-no-records", "message": "Record Not Found" } } Schemas AccountList NAMETYPEDESCRIPTIONaccountNumberstringAccount number of the party.virtualAccountNumberstringAccount number for the virtual account (VAM). Message NAMETYPEDESCRIPTIONcodestringStatic code assigned by the network or payment system.messagestringA human-readable message associated with the code. Metadata NAMETYPEDESCRIPTIONmessagesoptionalarrayMessage pageObjectPage Page NAMETYPEDESCRIPTIONpageNumberintegerThe number of the page being viewed.pageSizeintegerThe number of records per page.totalPagesintegerThe total number of pages available.totalRecordsintegerThe total number of the transactions (records) available in the result set.lastPagebooleanIndicates the last page of the total pages. PartyList NAMETYPEDESCRIPTIONnamestringContains the customer identification number and the company name. WireDetailTransaction NAMETYPEDESCRIPTIONtransactionIdstringThe unique ID number associated with the original payment request.transactionDatestringDate the transfer occurred. Format: YYYY-MM-DDtransactionAmountnumberThe dollar amount of the transaction.requestReferencestringA reference value for the original request that is useful for traceability and reporting. The ID cannot exceed 35 characters.sendersReferencestringA reference value provided by the sender. For outbound payments, this value is the same as the transaction ID. The ID cannot exceed 35 characters.creditorObjectPartyList creditorAccountObjectAccountList debtorObjectPartyList debtorAccountObjectAccountList originatorObjectPartyList originatorAccountObjectAccountList beneficiaryObjectPartyList beneficiaryAccountObjectAccountList ultimateCreditorObjectPartyList ultimateCreditorAccountObjectAccountList ultimateDebtorObjectPartyList ultimateDebtorAccountObjectAccountList remittanceInformationstringSpecific details associated with a transaction like an invoice number or customer details that provide a reason for the payment. WireListTransaction NAMETYPEDESCRIPTIONtransactionIdstringThe unique ID number associated with the original payment requesttransactionDatestringDate the transfer occurred. Format: YYYY-MM-DDtransactionAmountnumberThe dollar amount of the transaction.requestReferencestringA reference value for the original request that is useful for traceability and reporting. The ID cannot exceed 35 characters.sendersReferencestringA reference value provided by the sender. For outbound payments, this value is the same as the transaction ID. The ID cannot exceed 35 characters.creditorObjectPartyList creditorAccountObjectAccountList debtorObjectPartyList debtorAccountObjectAccountList Errors For more information about general errors, see Error handling.API-specific KeyBank error codes and details are in the ServiceError or errorResponse object with additional information specific to the API. The KeyBank error codes start with ECA-W with a three-digit number that follows. The number increases by one digit for each error message. For example, if you have an issue with your request that generates two error messages specific to the API, the codes will be ECA-W-001 and ECA-W-002.API specific KeyBank codes and messagesHTTPSTATUS CODECUSTOMSTATUS CODEDESCRIPTION200SECA-W-001 Transaction not found.The request was received, but there is no result for the requested criteria.299WECA-W-001 Request processing completed with warnings.This message occurs when multiple request parameters are provided, and some of the data are not available as part of response.400FECA-W-001 Request Validation failed.There is missing mandatory information like accountNumber, fromDate, or toDate. Review values for mandatory request fields.400FECA-W-002 Requested records range is greater than the allowed limit - 1000Response goes beyond 1000 transactions for the requested account. Change the request criteria to help limit returned transactions to the allowed amount. Changelog ReleaseAPI versionChange descriptionImpactApril 20251.3.0Deprecated endpoint /wireInquiry/v1/transactions/details and related schemas.To inquire about a wire transfer, use the two new endpoints to search for a list or by transaction ID. Added the following endpoints:Added /wire/v1/transactions/list.Added /v1/rtp/wire/detail/{transactionId}.HIGHMay 20241.2.1Added the requestReference parameter. In the request, enter a short note, keyword, or descriptor that you can use in the future to trace or verify the transaction. The requestReference value returns in the WireInquiryResult object.Add remittanceInfo to the WireInquiryResult response body. You can enter a line of concatenated values that detail the purpose of wire or a message to the recipients.Added beneficiary party information to the WireInquiryResult response body. Parameters added include: beneficiaryName, beneficiaryAccountNumber, beneficiaryCreditorPostalAddressLine1, beneficiaryCreditorPostalAddressLine2.X-CorrelationId has been removed as a request header field for all endpoints. The parameter is no longer in the request body, but still remains in the code. The system assigns a unique ID when you submit a request and returns the value in the response.MIDMarch 20241.1.5Updated pattern format for the channelCode parameter. This field is no longer case sensitive. You can input a mix of uppercase and/or lowercase letters and still generate a successful return.LOWDecember 20231.1.4Added channelCode (optional) parameter to WireInquiryRequest and WireInquiryResult objects.Add transactionCreateDate parameter to the WireInquiryResult object.Deprecated the mdmId field. Backend services and processes have been enhanced to authenticate client API calls without the need for an MDM ID.HIGHSeptember 20231.1.3The mdmId description has been updated to communicate that this field will soon deprecate in an upcoming release.Added VAM parameters creditVirtualAccount and debitVirtualAccount to the response object, WireInquiryResult. You can now reconcile funds based on virtual account numbers.LOWJuly 20231.1.1Added the customData parameter. You can append up to 500 characters of free-form text that stays with the transaction through its lifecycle.Removed properties. The addition of the customData parameter rendered the properties object redundant.Added the paySubType parameter on a transaction type response. You can now receive status information about a Fed Drawdown request and if it was successful (1032) or not successful (1033).MDM ID (mdmId) is no longer a required parameter, it is now optional.MIDMay 20231.1.0Changed parameter fromEnteredDate to fromDate.Changed toEnteredDate to toDate.Modified the format for the date parameters to match with KeyBank API standard date format of YYYY-MM-DD.The optional source parameter has been deprecated and removed.MIDDecember 20221.0.0Released on the Developer Portal. Impact levelsLOW: This is a minor change or enhancement that does not alter the operations of the API. Upgrading to the latest specifications is preferable but not required.MID: The previous API version is valid and operates, but does not contain latest enhancements. You need to update your specifications to get these enhancements.HIGH: The previous API version is no longer operable. You must upgrade to the latest specifications to access and use this API product. YAML file