Skip to content

List recipient accounts

Request

Fetches a list of the user's recipient accounts.

Notes about query params

  • All query parameters are optional.
  • Pagination is supported.
    • Set the size parameter to determine the number of accounts per page (max 20).
    • Set the seekPosition parameter to the value returned in the seekPositionForNext field of the previous response to retrieve the next page.
Security
UserToken
Query
creatorIdinteger, (int64)

Creator of the account.

profileIdinteger, (int64)

Filters by the personal or business profile that created the account. Defaults to the personal profile.

profileinteger, (int64)

Alias for profileId.

currencystring

Filters the response by target currency.

Useful for presenting a list of recipients to your customer when they have already indicated the target currency in your flow.

Supports comma-separated values (for example, USD,GBP).

activeboolean

Filters by whether the selected profile is active. Defaults to true.

Default:true
typestring

Filters the response by account type. Supports comma-separated values (for example, iban,swift_code).

ownedByCustomerboolean

Filters the response by whether the account is owned by the customer. Leave out to retrieve all accounts.

sizeinteger, (int32), <= 20

The number of accounts returned in a page of the response. Defaults to 20 (the maximum).

seekPositioninteger or null, (int64)

For pagination, use the value from the seekPositionForNext field of the previous response to retrieve the next page.

sortstring

Controls the sorting strategy for the response.

Uses comma-separated options (either id or currency first, followed by asc or desc for direction).

  • ?sort=id,asc sorts in ascending order by id.
  • ?sort=id,desc sorts in descending order by id.
  • ?sort=currency,asc sorts in ascending order by currency.
Example:sort=id,asc
Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Example:f47ac10b-58cc-4372-a567-0e02b2c3d479
curl -i -X GET \
  'https://api.wise.com/2026Q3/accounts?creatorId=0&profileId=0&profile=0&currency=string&active=true&type=string&ownedByCustomer=true&size=20&seekPosition=0&sort=id%2Casc' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479'

Responses

Paginated list of recipient accounts.

Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Echoed back when X-External-Correlation-Id was included in the request. Learn more.

Example:"f47ac10b-58cc-4372-a567-0e02b2c3d479"
x-trace-idstring

Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.

Example:"fba501b6d453b96789f52338f019341f"
Bodyapplication/json
contentArray of objects

List of recipient accounts returned for this page.

seekPositionForNextinteger, (int64)

Seek position for the next page of the response. For pagination, use this value for the seekPosition query parameter of your next request to fetch the next page.

seekPositionForCurrentinteger, (int64)

Seek position for the current page of the response. For pagination, use this value for the seekPosition query parameter of your next request to fetch this current page again.

sortobject

Sort metadata.

sizeinteger, (int32)

Page size returned.

Example:20
Response
{
  "content": [
    {
      "id": 40000000,
      "creatorId": 41000000,
      "profileId": 30000000,
      "name": { … },
      "currency": "GBP",
      "country": "GB",
      "type": "SortCode",
      "legalEntityType": "PERSON",
      "active": true,
      "details": { … },
      "commonFieldMap": { … },
      "hash": "666ef880f8aa6113fa112ba6531d3ed2c26dd9fgbd7de5136bfb827a6e800479",
      "accountSummary": "(04-00-75) 37778842",
      "longAccountSummary": "GBP account ending in 8842",
      "displayFields": [ … ],
      "isInternal": false,
      "ownedByCustomer": false
    }
  ],
  "seekPositionForNext": 40000001,
  "seekPositionForCurrent": 40000000,
  "sort": {
    "empty": true,
    "sorted": false,
    "unsorted": true
  },
  "size": 20
}