Skip to main content
GET
/
api
/
payouts
/
recipients
/
{id}
Get a recipient
curl --request GET \
  --url https://business.madhousewallet.com/api/payouts/recipients/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": 12345678,
  "accountHolderName": "Jane Doe",
  "currency": "EUR",
  "type": "iban",
  "active": true,
  "details": {},
  "country": "DE"
}

Authorizations

​
Authorization
string
header
required

Pass your API key as a Bearer token: Authorization: Bearer mw_live_<keyId>_<secret>

Path Parameters

​
id
integer
required

Recipient account ID

Example:

12345678

Response

Recipient returned

A payout recipient account

​
id
integer
required

Recipient account ID

Example:

12345678

​
accountHolderName
string
required

Name on the account

Example:

"Jane Doe"

​
currency
string
required

ISO 4217 currency code

Example:

"EUR"

​
type
string
required

Account type (e.g. iban, sort_code, aba)

Example:

"iban"

​
active
boolean
required

Whether the recipient is active

Example:

true

​
details
object
required

Account-type-specific details (routing/account numbers, IBAN, etc.)

​
country
string | null

ISO 3166-1 alpha-2 country code

Example:

"DE"