Get all split beneficiaries
curl --request GET \
--url https://checkout-staging.embedly.ng/api/v1/split-beneficiaries \
--header 'x-api-key: <api-key>'import requests
url = "https://checkout-staging.embedly.ng/api/v1/split-beneficiaries"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://checkout-staging.embedly.ng/api/v1/split-beneficiaries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://checkout-staging.embedly.ng/api/v1/split-beneficiaries",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://checkout-staging.embedly.ng/api/v1/split-beneficiaries"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://checkout-staging.embedly.ng/api/v1/split-beneficiaries")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://checkout-staging.embedly.ng/api/v1/split-beneficiaries")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"statusCode": 200,
"message": "Beneficiaries retrieved successfully",
"data": {
"beneficiaries": [
{
"id": "6b6e94a9-c795-4c22-a94a-bc3fce632cc9",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "string",
"accountNumber": "4278816936",
"bankCode": "string",
"bankName": "string",
"beneficiaryAlias": "string",
"isActive": true,
"createdAt": "2026-02-16T07:59:45.982564Z",
"updatedAt": "2026-02-16T08:01:42.358107Z"
},
{
"id": "1c7e2c80-9f8c-4bd8-8c9d-bd63810c5df9",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "string",
"accountNumber": "4278816938",
"bankCode": "string",
"bankName": "string",
"beneficiaryAlias": "string",
"isActive": true,
"createdAt": "2026-02-16T07:57:04.468813Z",
"updatedAt": null
},
{
"id": "97c576be-7953-4b58-8699-2b0cd2265857",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "2345667880",
"bankCode": "000007",
"bankName": "Fidelity Bank",
"beneficiaryAlias": "testing",
"isActive": true,
"createdAt": "2026-01-28T08:20:13.899217Z",
"updatedAt": null
},
{
"id": "0c11927f-f4a3-4c0b-b712-db457375ad43",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "0108834787",
"bankCode": "000009",
"bankName": "Citi Bank",
"beneficiaryAlias": "testing",
"isActive": true,
"createdAt": "2026-01-23T16:10:55.768738Z",
"updatedAt": null
},
{
"id": "6978ba2c-b7dd-4d7c-aca2-293695637977",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "2345667887",
"bankCode": "000013",
"bankName": "GTBank Plc",
"beneficiaryAlias": "pop",
"isActive": true,
"createdAt": "2026-01-21T08:43:30.223918Z",
"updatedAt": null
},
{
"id": "8ccbefcb-f90b-431b-bec6-c35b0ca96daf",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "2345667881",
"bankCode": "090108",
"bankName": "New Prudential Bank",
"beneficiaryAlias": "New",
"isActive": true,
"createdAt": "2026-01-20T08:06:48.919992Z",
"updatedAt": null
},
{
"id": "0dc6566a-dc10-4cd4-945a-620c71ef3d11",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "0000000000",
"bankCode": "000009",
"bankName": null,
"beneficiaryAlias": "John Doe",
"isActive": true,
"createdAt": "2026-01-19T17:36:38.598417Z",
"updatedAt": "2026-01-21T17:06:32.333421Z"
}
],
"page": 1,
"pageSize": 20,
"totalCount": 15,
"totalPages": 1
}
}
{
"code": "401",
"success": false,
"message": "x-api-key is missing in the header",
"data": null
}
{
"statusCode": 403,
"message": "Access denied. The API key provided is for another organization. You can only access your organization's wallets.",
"data": null
}
Split Checkout
Get all split beneficiaries
Retrieves all split beneficiaries for the authenticated organization with optional filters for active status and search term. Supports pagination. Organization API key required.
GET
/
api
/
v1
/
split-beneficiaries
Get all split beneficiaries
curl --request GET \
--url https://checkout-staging.embedly.ng/api/v1/split-beneficiaries \
--header 'x-api-key: <api-key>'import requests
url = "https://checkout-staging.embedly.ng/api/v1/split-beneficiaries"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://checkout-staging.embedly.ng/api/v1/split-beneficiaries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://checkout-staging.embedly.ng/api/v1/split-beneficiaries",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://checkout-staging.embedly.ng/api/v1/split-beneficiaries"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://checkout-staging.embedly.ng/api/v1/split-beneficiaries")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://checkout-staging.embedly.ng/api/v1/split-beneficiaries")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"statusCode": 200,
"message": "Beneficiaries retrieved successfully",
"data": {
"beneficiaries": [
{
"id": "6b6e94a9-c795-4c22-a94a-bc3fce632cc9",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "string",
"accountNumber": "4278816936",
"bankCode": "string",
"bankName": "string",
"beneficiaryAlias": "string",
"isActive": true,
"createdAt": "2026-02-16T07:59:45.982564Z",
"updatedAt": "2026-02-16T08:01:42.358107Z"
},
{
"id": "1c7e2c80-9f8c-4bd8-8c9d-bd63810c5df9",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "string",
"accountNumber": "4278816938",
"bankCode": "string",
"bankName": "string",
"beneficiaryAlias": "string",
"isActive": true,
"createdAt": "2026-02-16T07:57:04.468813Z",
"updatedAt": null
},
{
"id": "97c576be-7953-4b58-8699-2b0cd2265857",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "2345667880",
"bankCode": "000007",
"bankName": "Fidelity Bank",
"beneficiaryAlias": "testing",
"isActive": true,
"createdAt": "2026-01-28T08:20:13.899217Z",
"updatedAt": null
},
{
"id": "0c11927f-f4a3-4c0b-b712-db457375ad43",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "0108834787",
"bankCode": "000009",
"bankName": "Citi Bank",
"beneficiaryAlias": "testing",
"isActive": true,
"createdAt": "2026-01-23T16:10:55.768738Z",
"updatedAt": null
},
{
"id": "6978ba2c-b7dd-4d7c-aca2-293695637977",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "2345667887",
"bankCode": "000013",
"bankName": "GTBank Plc",
"beneficiaryAlias": "pop",
"isActive": true,
"createdAt": "2026-01-21T08:43:30.223918Z",
"updatedAt": null
},
{
"id": "8ccbefcb-f90b-431b-bec6-c35b0ca96daf",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "2345667881",
"bankCode": "090108",
"bankName": "New Prudential Bank",
"beneficiaryAlias": "New",
"isActive": true,
"createdAt": "2026-01-20T08:06:48.919992Z",
"updatedAt": null
},
{
"id": "0dc6566a-dc10-4cd4-945a-620c71ef3d11",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "0000000000",
"bankCode": "000009",
"bankName": null,
"beneficiaryAlias": "John Doe",
"isActive": true,
"createdAt": "2026-01-19T17:36:38.598417Z",
"updatedAt": "2026-01-21T17:06:32.333421Z"
}
],
"page": 1,
"pageSize": 20,
"totalCount": 15,
"totalPages": 1
}
}
{
"code": "401",
"success": false,
"message": "x-api-key is missing in the header",
"data": null
}
{
"statusCode": 403,
"message": "Access denied. The API key provided is for another organization. You can only access your organization's wallets.",
"data": null
}
string
required
The unique organizationId. Example:
3fa85f64-5717-4562-b3fc-2c963f66afa6string
default:"1"
string
default:"10"
boolean
string
{
"statusCode": 200,
"message": "Beneficiaries retrieved successfully",
"data": {
"beneficiaries": [
{
"id": "6b6e94a9-c795-4c22-a94a-bc3fce632cc9",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "string",
"accountNumber": "4278816936",
"bankCode": "string",
"bankName": "string",
"beneficiaryAlias": "string",
"isActive": true,
"createdAt": "2026-02-16T07:59:45.982564Z",
"updatedAt": "2026-02-16T08:01:42.358107Z"
},
{
"id": "1c7e2c80-9f8c-4bd8-8c9d-bd63810c5df9",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "string",
"accountNumber": "4278816938",
"bankCode": "string",
"bankName": "string",
"beneficiaryAlias": "string",
"isActive": true,
"createdAt": "2026-02-16T07:57:04.468813Z",
"updatedAt": null
},
{
"id": "97c576be-7953-4b58-8699-2b0cd2265857",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "2345667880",
"bankCode": "000007",
"bankName": "Fidelity Bank",
"beneficiaryAlias": "testing",
"isActive": true,
"createdAt": "2026-01-28T08:20:13.899217Z",
"updatedAt": null
},
{
"id": "0c11927f-f4a3-4c0b-b712-db457375ad43",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "0108834787",
"bankCode": "000009",
"bankName": "Citi Bank",
"beneficiaryAlias": "testing",
"isActive": true,
"createdAt": "2026-01-23T16:10:55.768738Z",
"updatedAt": null
},
{
"id": "6978ba2c-b7dd-4d7c-aca2-293695637977",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "2345667887",
"bankCode": "000013",
"bankName": "GTBank Plc",
"beneficiaryAlias": "pop",
"isActive": true,
"createdAt": "2026-01-21T08:43:30.223918Z",
"updatedAt": null
},
{
"id": "8ccbefcb-f90b-431b-bec6-c35b0ca96daf",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "2345667881",
"bankCode": "090108",
"bankName": "New Prudential Bank",
"beneficiaryAlias": "New",
"isActive": true,
"createdAt": "2026-01-20T08:06:48.919992Z",
"updatedAt": null
},
{
"id": "0dc6566a-dc10-4cd4-945a-620c71ef3d11",
"organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
"beneficiaryName": "John Doe",
"accountNumber": "0000000000",
"bankCode": "000009",
"bankName": null,
"beneficiaryAlias": "John Doe",
"isActive": true,
"createdAt": "2026-01-19T17:36:38.598417Z",
"updatedAt": "2026-01-21T17:06:32.333421Z"
}
],
"page": 1,
"pageSize": 20,
"totalCount": 15,
"totalPages": 1
}
}
{
"code": "401",
"success": false,
"message": "x-api-key is missing in the header",
"data": null
}
{
"statusCode": 403,
"message": "Access denied. The API key provided is for another organization. You can only access your organization's wallets.",
"data": null
}
⌘I