Skip to main content
GET
/
beneficiaries
/
loan-clients
/
{org_id}
List beneficiaries by organisation
curl --request GET \
  --url https://api.pcxpay.com/v1/beneficiaries/loan-clients/{org_id}
{
  "data": [
    {
      "beneficiary_id": "<string>",
      "account_type": "bank",
      "beneficiary_of": "<string>",
      "beneficiary_type": "loan_client",
      "country": "<string>",
      "currency": "<string>",
      "fname": "<string>",
      "lname": "<string>",
      "email": "<string>",
      "phone_number": "<string>",
      "momo_details": {},
      "bank_details": {},
      "loan_client_details": {},
      "external_account_id": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>"
    }
  ],
  "pagination": {}
}

Path Parameters

​
org_id
string
required

Query Parameters

​
type
enum<string>

Filter by beneficiary_type (e.g. loan_client, payout_recipient).

Available options:
loan_client,
payout_recipient
​
query
string

Free-text search string applied by the use-case layer.

​
limit
integer
default:10
​
next_token
string

JSON-encoded DynamoDB pagination token from a previous response.

Response

Organisation beneficiary list

​
data
object[]
​
pagination
object

DynamoDB pagination info returned by the use-case layer.