List connectors

Discovers connectors for a corridor. Fees are not part of the response (they are internal pricing inputs; use POST /v1/quotes for authoritative pricing). The connector id is the handle quotes and requirements take.

GET /connectors

List connectors

cURL

curl --request GET \
  --url https://api.zeam.money/gw/v1/connectors \
  --header 'Authorization: Bearer <token>' \
  --header 'x-zeam-auth: <api-key>'

200

{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "acceptedAsset": "<string>",
      "destinationAsset": "<string>",
      "direction": "OFF_RAMP",
      "method": "MOBILE_MONEY",
      "status": "ACTIVE",
      "requiresQuote": true,
      "isActive": true,
      "methodProvider": {
        "id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "imageUrl": "<string>"
      },
      "limits": [
        {
          "id": "<string>",
          "scope": "<string>",
          "type": "<string>",
          "duration": 123,
          "minValue": 123,
          "maxValue": 123,
          "currency": "<string>"
        }
      ],
      "execution": [
        {
          "step": 123,
          "name": "<string>",
          "path": "<string>",
          "method": "<string>",
          "additionalInstructions": "<string>"
        }
      ],
      "transactionTypes": [
        {
          "type": "C2C",
          "status": "ONLINE"
        }
      ],
      "supportedTransactionType": {
        "b2b": true,
        "b2c": true,
        "c2b": true,
        "c2c": true
      },
      "region": {
        "iso": "<string>"
      }
    }
  ],
  "pagination": {
    "nextCursor": "<string>",
    "hasMore": true
  }
}

Authorizations

Authorization · string · header · required

Access token issued by POST /v1/auth/token.

x-zeam-auth · string · header · required

Application secret (the apiKey issued at registration), required on every request.

Query Parameters

countryIsoCode2 · string · required

ISO 3166-1 alpha-2 country code (uppercase).

Pattern: ^[A-Z]{2}$

Example:

"ZW"

method · string · required

Payment method enum (uppercase).

Pattern: ^[A-Z0-9_]+$

Example:

"MOBILE_MONEY"

direction · enum<string> · required

Corridor direction.

Available options: ON_RAMP, OFF_RAMP

Example:

"OFF_RAMP"

Response

200

application/json

A page of connectors.

data · object[] · required

Show child attributes

pagination · object · required

Show child attributes