Skip to content
API Reference/
Money Transfer
/
/Catalogs

Catalogs

This section provides the Catalogs endpoints required to manage and operate the full lifecycle of resources within the ViaBlocks platform. These endpoints are designed for secure, auditable, and scalable server-to-server integrations, and support core business operations and compliance workflows.

Operations

/catalogs/countries/{deliveryCountryISO}/currencies

Request

Purpose

Returns the list of supported currencies for the specified country.

When to use

Use this endpoint to:

  • Populate currency selection options
  • Validate corridor currency support before transaction creation

Authentication

Requires x-client-id and x-secret-key headers.

Notes

  • deliveryCountryISO is an ISO3 country code (e.g., USA, MEX, COL).

Common errors

  • 400 Validation errors
  • 401 Invalid credentials
  • 404 Country not found (when applicable)
  • 500 Internal error
Path
deliveryCountryISOstringrequired

Country ISO3 code (e.g., USA, MEX, COL)

Example:USA
Headers
x-client-idstring, [ 16 .. 64 ] charactersrequired

Error codes: required=400001, type=400002, minLength=400003, maxLength=400004

Example:xxxx123456789
x-secret-keystring, [ 32 .. 128 ] charactersrequired

Error codes: required=400001, type=400002, minLength=400003, maxLength=400004

Example:xxxx987654321
GET
/catalogs/countries/{deliveryCountryISO}/currencies
curl -i -X GET \
  https://sandbox-viablocks.viamericas.io/catalogs/countries/USA/currencies \
  -H 'x-client-id: xxxx123456789' \
  -H 'x-secret-key: xxxx987654321'

Responses

Response success

Bodyapplication/json
Array [
idstring
namestring
codestring
]
Response
[
  {
    "id": "1",
    "name": "US Dollar",
    "code": "USD"
  },
  {
    "id": "2",
    "name": "Euro",
    "code": "EUR"
  }
]