v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

recipient

List recipient accounts

Fetch a list of the user's recipient accounts. Use the profileId parameter to filter by the profile who created the accounts, you should do this based on the personal or business profile ID you have linked to, based on your use case. Other filters are listed below for your convenience, for example currency is a useful filter to use when presenting the user a list of recipients to choose from in the case they have already submitted the target currency in your flow.

Pagination

Pagination is supported for this endpoint. The response includes the seekPositionForNext and size parameters to manage this.

It works by setting size and seekPosition parameters in the call. Set the value in the seekPositionForNext of the previous response into the seekPosition parameter of your subsequent call in order to get the next page. To get the current page again, use the seekPositionForCurrent value.

Sorting

You can also set the sort parameter to control the sorting of the response, for example:

?sort=id,asc sort by id ascending.<br> ?sort=id,desc sort by id descending.<br> ?sort=currency,asc sort by currency ascending.

All query parameters are optional.

get/v2/accounts

Query parameters

creatorIdinteger

Creator of the account.

profileIdinteger

Filter by personal or business profile. Defaults to the personal profile.

profileinteger

Alias for profileId.

currencystring

Filter responses by currency. Comma separated values supported (e.g. USD,GBP).

activeboolean

Filter by whether this profile is active. Defaults to true.

typestring

Filter responses by account type. Comma separated values supported (e.g. iban,swift_code).

ownedByCustomerboolean

Filter to get accounts owned by the customer or not. Leave out to get all accounts.

sizeinteger

Page size of the response. Defaults to a maximum of 20.

seekPositioninteger nullable

Account ID to start the page of responses from. null if no more pages.

sortstring

Example:id,asc

Sorting strategy for the response. Comma separated options - firstly either id or currency, followed by asc or desc for direction.

Headers

X-External-Correlation-Idstring uuid

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

Response

Paginated list of recipient accounts.

seekPositionForNextinteger

Seek position for the next page (use as seekPosition to fetch the next page).

seekPositionForCurrentinteger

Seek position for the current page.

sizeinteger

Page size returned.

Example response

{
  "content": [
    {
      "id": 40000000,
      "creatorId": 41000000,
      "profileId": 30000000,
      "name": {
        "fullName": "John Doe"
      },
      "currency": "GBP",
      "country": "GB",
      "type": "SortCode",
      "legalEntityType": "PERSON",
      "active": true,
      "details": {
        "sortCode": "040075",
        "accountNumber": "37778842",
        "hashedByLooseHashAlgorithm": "ad245621b974efa3ef870895c3wer419a3f01af18a8a5790b47645dba6304194"
      },
      "commonFieldMap": {
        "accountNumberField": "accountNumber",
        "bankCodeField": "sortCode"
      },
      "hash": "666ef880f8aa6113fa112ba6531d3ed2c26dd9fgbd7de5136bfb827a6e800479",
      "accountSummary": "(04-00-75) 37778842",
      "longAccountSummary": "GBP account ending in 8842",
      "displayFields": [
        {
          "key": "details/sortCode",
          "label": "UK sort code",
          "value": "04-00-75"
        },
        {
          "key": "details/accountNumber",
          "label": "Account number",
          "value": "37778842"
        }
      ],
      "ultimateBeneficiary": {
        "accountNumber": "37778842",
        "bankName": "Wise Payments Limited",
        "bankCode": "026073150",
        "name": {
          "fullName": "John Doe"
        },
        "address": {
          "country": "US"
        },
        "bankAddress": {
          "country": "US"
        }
      },
      "confirmations": {
        "outcomes": [
          {
            "type": "NAME_MATCHING",
            "timestamp": "2024-11-11T23:58:11.105916743Z",
            "outcome": "PARTIAL_FAILURE",
            "requiresCustomerAcceptance": true,
            "fieldsChecked": [
              "name/fullName",
              "details/accountNumber"
            ],
            "providedName": "John Doe",
            "resolvedName": "Joe Doe",
            "message": "The name entered is slightly different to the name on the account.",
            "recommendedUpdates": [
              {
                "path": "name/fullName",
                "value": "Joe Doe"
              }
            ]
          }
        ]
      }
    }
  ],
  "size": 20
}