Skip to main content

Relationships

Relationships are used on the RTGS.global network to ensure participants can only interact with each other where they have agreed a technical connection. Relationships are needed to send requests for FX Quotes, and for making cross-border payments via another participant.

Overview​

Relationships ensure participants can only interact with each other where they have mutually agreed a technical connection. They enable FX Quote requests and cross-border payments between participants. Relationships are managed through the Participant Portal or via the API.

Users access relationship information by clicking Relationships in the navigation bar.

Process​

Step 1: Discover Participants​

Use the GET /participants API endpoint or the Participant Portal to discover participants available to connect with.

Via the Portal:

  1. Navigate to Relationships → Add Relationship tab
  2. Select a Funds Controller to view active participants in that jurisdiction
  3. The Available Participants section displays eligible connections

Step 2: Send a Host Relationship Request​

Requests you send to other participants are referred to as outbound relationship requests. Host relationships enable network accounts across jurisdictions.

Submit via:

  • POST /relationships API endpoint
  • Participant Portal — Add Relationship form

Step 3: View Pending Relationship Requests​

View the status of outbound requests via:

  • GET /relationships API endpoint
  • Participant Portal — Pending Relationship Requests tab

Step 4: Approve Host Relationship Requests​

Requests received from other participants are referred to as inbound requests. You can approve or reject them via:

  • PATCH /relationships API endpoint
  • Participant Portal — Pending Relationship Requests tab

When approving, you must:

  • Provide a unique addressable account identifier
  • Select an Account ID Type (IBAN or Other)

Approval activates the relationship and automatically creates a network account.

Step 5: View Network Accounts​

Once a relationship is active, access account information via:

  • GET /accounts API endpoint
  • Participant Portal — Accounts section

Non-Host Relationship Requests​

Non-host relationships enable:

  • FX Quote requests between participants
  • Cross-border payment forwarding
  • Multiple relationships from a single account

They are required for payment forwarding within local jurisdictions.