Revolut - Get Counterparties

Description

This module allows getting the counterparties (transfer recipients) configured in Revolut Business. It can query a specific counterparty by ID or search by name.

Configuration

Field	Type	Required	Description
credentials_id	credential	Yes	Revolut credentials
counterparty_id	string	No	Specific counterparty UUID
name	string	No	Search by name

Credentials

This module requires Revolut Business type credentials with the following fields:

Field	Description
`access_token`	Revolut Business API access token
`sandbox`	Sandbox mode for testing (true/false)

Output

Specific counterparty

{
  "success": true,
  "counterparty": { ... },
  "counterparty_id": "a1b2c3d4-...",
  "name": "Proveedor ABC",
  "type": "business",
  "state": "created",
  "accounts": [
    {
      "id": "acc-123",
      "currency": "EUR",
      "type": "external",
      "iban": "DE89370400440532013000"
    }
  ],
  "message": "Contraparte Proveedor ABC obtenida"
}

Counterparty list

{
  "success": true,
  "counterparties": [ ... ],
  "total": 25,
  "by_type": {
    "personal": 10,
    "business": 15
  },
  "revolut_accounts": 8,
  "external_accounts": 17,
  "message": "25 contrapartes encontradas"
}

Counterparty Types

Type	Description
personal	Personal account
business	Business account

Account Types

Type	Description
revolut	Revolut account (instant transfer)
external	External bank account (SWIFT/SEPA)

Usage Example

{
  "credentials_id": "revolut_empresa",
  "name": "Proveedor"
}

API Used

API: Revolut Business API
Endpoint: GET /api/1.0/counterparties, GET /api/1.0/counterparty/{id}
Documentation: https://developer.revolut.com/docs/business/counterparties

Notes

Transfers to Revolut accounts are instant and free
Transfers to external accounts may have fees
Each counterparty can have multiple accounts in different currencies

RevolutCreateCounterparty: Create new counterparties
RevolutCreatePayment: Create payments to counterparties
RevolutSchedulePayment: Schedule payments to counterparties