List recipients

GET /recipients

Get all recipients for the authenticated workspace

Headers

  • Workspace-ID integer Required

    The workspace ID - to identify the sub-user

Responses

  • 200 application/json

    List of recipients

    Hide response attributes Show response attributes object
    • accountCode string Required

      Recipient account code

    • alias string

      Recipient nickname

    • createdAt string

      Creation timestamp

    • edges object
      Hide edges attributes Show edges attributes object
      • bank object

        Bank information including name and SWIFT code

        Hide bank attributes Show bank attributes object
        • countryCode string

          Bank country code (ISO 3166-1 alpha-2)

        • createdAt string

          Creation timestamp

        • id integer Required

          Bank ID

        • name string Required

          Bank name

        • swiftCode string

          Bank SWIFT/BIC code

        • updatedAt string

          Last update timestamp

      • beneficiary object

        Beneficiary information for international transfers

        Hide beneficiary attributes Show beneficiary attributes object
        • createdAt string

          Creation timestamp

        • data object
        • id integer Required

          Beneficiary ID

        • updatedAt string

          Last update timestamp

      • currency object

        Currency information including symbol, code, and decimal places

        Hide currency attributes Show currency attributes object
        • code string Required

          ISO currency code (e.g., USD, EUR)

        • createdAt string

          Creation timestamp

        • decimals integer

          Number of decimal places

        • id integer Required

          Currency ID

        • name string Required

          Currency full name

        • swiftMinimumWithdrawalAmount string

          Minimum SWIFT withdrawal amount

        • symbol string

          Currency symbol (e.g., $, €)

        • updatedAt string

          Last update timestamp

    • id integer Required

      Recipient ID

    • name string Required

      Recipient name

    • saved boolean

      Whether recipient is saved

    • updatedAt string

      Last update timestamp

  • 401 application/json

    Unauthorized

    Hide response attributes Show response attributes object
    • errorCode string Required

      Error code

    • message string Required

      Error message

GET /recipients
curl \
 --request GET 'https://bank.bank.place/recipients' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Workspace-ID: 42"
Response examples (200)
[
  {
    "accountCode": "string",
    "alias": "string",
    "createdAt": "string",
    "edges": {
      "bank": {
        "countryCode": "string",
        "createdAt": "string",
        "id": 42,
        "name": "string",
        "swiftCode": "string",
        "updatedAt": "string"
      },
      "beneficiary": {
        "createdAt": "string",
        "data": {},
        "id": 42,
        "updatedAt": "string"
      },
      "currency": {
        "code": "string",
        "createdAt": "string",
        "decimals": 42,
        "id": 42,
        "name": "string",
        "swiftMinimumWithdrawalAmount": "string",
        "symbol": "string",
        "updatedAt": "string"
      }
    },
    "id": 42,
    "name": "string",
    "saved": true,
    "updatedAt": "string"
  }
]
Response examples (401)
{
  "message": "Invalid request parameters",
  "errorCode": "invalid_request"
}