western-union

western-union Balances API

Holding balance inquiry.

Documentation GitHub OpenAPI

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/western-union-balances-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: Western Union Mass Payments Balances API
  description: The Western Union Mass Payments API enables financial institutions and enterprise customers to send up to 10,000 international payments in a single batch across 130+ currencies in 200+ countries and territories. The API supports payment lifecycle management including batch creation, adding payments, FX quotes, committing, and tracking. Authentication requires mutual TLS (mTLS) client certificates provided by Western Union upon partnership enrollment.
  version: v1
  contact:
    name: Western Union Partnership Program
    url: https://developer.westernunion.com/getting-started.html
    email: wuconnect@westernunion.com
  license:
    name: Western Union Partner Terms
    url: https://developer.westernunion.com/getting-started.html
servers:
- url: https://api.westernunion.com
  description: Production endpoint
- url: https://api-sandbox.westernunion.com
  description: Sandbox for testing
tags:
- name: Balances
  description: Holding balance inquiry.
paths:
  /HoldingBalance/{clientId}/{currencyCode}:
    get:
      operationId: getHoldingBalance
      summary: Get Holding Balance
      description: Returns the current holding balance for the specified currency in the partner's WU account. Used to verify sufficient funds before initiating payments.
      tags:
      - Balances
      security:
      - mtlsAuth: []
      parameters:
      - name: clientId
        in: path
        required: true
        schema:
          type: string
        description: The partner's Western Union client ID.
      - name: currencyCode
        in: path
        required: true
        schema:
          type: string
          pattern: ^[A-Z]{3}$
        description: ISO 4217 currency code (e.g., USD, EUR, GBP).
      responses:
        '200':
          description: Holding balance for the specified currency.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HoldingBalanceResponse'
        '401':
          description: Authentication failed.
        '404':
          description: Client or currency not found.
components:
  schemas:
    HoldingBalance:
      type: object
      properties:
        currencyCode:
          type: string
          description: ISO 4217 currency code.
        amount:
          type: number
          format: double
          description: Available balance amount.
    HoldingBalanceResponse:
      type: object
      properties:
        clientId:
          type: string
        currencyCode:
          type: string
        balance:
          $ref: '#/components/schemas/HoldingBalance'
  securitySchemes:
    mtlsAuth:
      type: mutualTLS
      description: Mutual TLS authentication using client certificates provided by Western Union upon enrollment in the Partnership Program. Include the certificate and key with every request.