Get a beneficiary

Get beneficiary by ID

get

https://stage-capi.wewireafrica.comhttps://capi.wewireafrica.com

/v1/beneficiaries/{beneficiaryId}

Authorizations

bearerww-api-key

Path parameters

beneficiaryIdstringRequired

Beneficiary ID

Responses

200

The beneficiary

application/json

idstringRequired

Unique beneficiary identifier

typestring · enumRequired

Beneficiary type

Possible values:

namestringOptional

Beneficiary name (for business type)

firstNamestringOptional

First name

lastNamestringOptional

Last name

emailstringOptional

Email address

telephonestringOptional

Telephone number

externalIdstringOptional

External identifier

addressLine1stringOptional

Address line 1

addressLine2stringOptional

Address line 2

buildingNamestringOptional

Building name

postalCodestringOptional

Postal code

citystringOptional

City

countrystringOptional

Country

statestringOptional

State

businessIdstringRequired

Associated business ID

createdAtstring · date-timeRequired

Beneficiary creation timestamp

updatedAtstring · date-timeOptional

Beneficiary last update timestamp

get

/v1/beneficiaries/{beneficiaryId}

HTTPcURLJavaScriptPython

GET /v1/beneficiaries/{beneficiaryId} HTTP/1.1
Host: stage-capi.wewireafrica.com
Accept: */*

200

The beneficiary

{
  "id": "text",
  "type": "INDIVIDUAL",
  "name": "text",
  "firstName": "text",
  "lastName": "text",
  "email": "text",
  "telephone": "text",
  "externalId": "text",
  "addressLine1": "text",
  "addressLine2": "text",
  "buildingName": "text",
  "postalCode": "text",
  "city": "text",
  "country": "text",
  "state": "text",
  "businessId": "text",
  "beneficiaryAccounts": [
    {
      "id": "text",
      "bankName": "text",
      "accountName": "text",
      "accountNumber": "text",
      "country": "text",
      "swiftBic": "text",
      "routingNumber": "text",
      "iban": "text",
      "sortCode": "text",
      "currency": "NGN",
      "type": "MOBILE_MONEY",
      "settlementMethod": "ACH",
      "accountCategory": "CHECKING",
      "externalId": "text",
      "extraFields": {},
      "createdAt": "2026-03-20T13:33:29.385Z",
      "updatedAt": "2026-03-20T13:33:29.385Z"
    }
  ],
  "createdAt": "2026-03-20T13:33:29.385Z",
  "updatedAt": "2026-03-20T13:33:29.385Z"
}