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

RTR Sandbox - Inbound Exchange Heartbeat API

Real-Time Rail sandbox API for sending heartbeat requests between a participant and the RTR exchange (ISO 20022 admi.004 System Event Notification), returning admi.011 System Event Acknowledgement or admi.002 Message Reject. OAuth2 client-credentials; OpenAPI 3.0.3 harvested verbatim.

RTR Sandbox - Inbound Exchange Heartbeat API is one of 10 APIs that Payments Canada publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Real-Time Rail, ISO 20022, and Monitoring. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 1 operation across 1 path, and defines 5 schemas. It is described by OpenAPI 3.0.3, at version 1.1.0.

Requests are made against a single base URL, https://api.payments.ca/rtr-sandbox.

1 operations 1 paths 5 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.1.0
Base URL
https://api.payments.ca/rtr-sandbox
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

RTR Sandbox - Inbound Exchange Heartbeat API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oAuth) using the clientCredentials flow, exposing 1 scope.

  • oAuth — This API uses OAuth 2 with the implicit grant flow. (The access token expires in 5 minutes)

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

application level heartbeat 1
POST
/inbound-heartbeat
Receive Heartbeat Request
3 params body → 400401403404429500503200

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are SyntaxError (1 property), IsoHeader (1 property), HeartbeatResponse (1 property). Each schema is shown below with its type and property counts.

AdmiResponse
HeartbeatResponse
object
admi.011 message wrapper
1 property 1 required
IsoHeader
object
1 property 1 required
ReceiveHeartbeat
admi.004 message wrapper
SyntaxError
object
admi.002 message wrapper for syntax errors in API request payload.
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

rtr-inbound-csp-heartbeat-api-openapi.yml Raw ↑

Other APIs Payments Canada publishes across the network.

RTR Sandbox - Inbound Participant Payment API
RTR Sandbox - Interest Report API
RTR Sandbox - Payment Capacity Balance Report API
Lynx Sandbox API
ACSS API
FIF Extracts API
FIF Branch API
CCIN Extracts API
CCIN Lookup API