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 - Payment Capacity Balance Report API

Real-Time Rail sandbox clearing-and-settlement API that calls the C&S system to generate a payment-capacity balance report (ISO 20022 camt.003 Get Account returning camt.004 Return Account with balance data). OAuth2 client-credentials; OpenAPI 3.0.3 harvested verbatim.

RTR Sandbox - Payment Capacity Balance Report 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, Clearing and Settlement, and ISO 20022. 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 44 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 44 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 - Payment Capacity Balance Report 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.

report 1
POST
/payment-capacity-balance-report
This service can be used by the Participants to retrieve the Balance Report. Message format - ISO 20022 camt.003.001.07 with BAH ISO 20022 head.001.001.02
2 params body → 200401429500

Schemas 44

The contract defines 44 schemas that model the data the API accepts and returns. The most detailed are BalanceRequest (2 properties), BalanceResponse (1 property). Each schema is shown below with its type and property counts.

BalanceRequest
object
2 properties 2 required
BalanceResponse
object
1 property 1 required
BusinessApplicationHeaderV02
BranchAndFinancialInstitutionIdentification6__head_1
ClearingSystemMemberIdentification2__head_1
FinancialInstitutionIdentification18__head_1
GenericOrganisationIdentification1__1
OrganisationIdentification29__1
Party38Choice__1
Party44Choice__1
PartyIdentification135__1
GetAccountV07
MessageHeader9__1
AccountQuery3__1
AccountCriteria3Choice__1
ReturnAccountV08
GenericAccountIdentification1__1
CashAccount37__1
AccountReport24__1
ErrorHandling5__1
AccountIdentification4Choice__1
AccountOrBusinessError4Choice__1
GenericIdentification1__1
FinancialInstitutionIdentification18__camt004_1
ActiveOrHistoricCurrencyCode
BranchAndFinancialInstitutionIdentification6__camt004_1
CashBalance13__1
ImpliedCurrencyAndAmount
CreditDebitCode
BalanceType11Choice__1
DateAndDateTime2Choice__1
BalanceRestrictionType1__1
ExternalSystemErrorHandling1Code
ErrorHandling3Choice
ClearingSystemMemberIdentification2__camt_1
OriginalBusinessQuery1__1
MessageHeader7__1
AccountOrOperationalError4Choice__1
MessageReference
MessageReject
RejectionReason
ISODateTime
UUIDv4Identifier
ISODate

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

rtr-balance-report-api-openapi.yml Raw ↑

Other APIs Payments Canada publishes across the network.

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