Skip to main content
GET
/
embedded
/
api
/
v1
/
wallets
/
org
/
wallets
Get all virtual Wallets for an Organization's Business
curl --request GET \
  --url https://api-dev-embedded.embedly.ng/embedded/api/v1/wallets/org/wallets
{
  "data": [
    {
      "id": "string",
      "orgId": "string",
      "businessId": "string",
      "accountNumber": "1234567890",
      "bankCode": "999999",
      "type": "virtual",
      "isFrozen": true,
      "isExpired": false,
      "status": true,
      "expiresAt": null,
      "reason": null,
      "label": "Vendor Payout Wallet",
      "accountName": "Vendor Payout Wallet",
      "dateCreated": "2025-06-16T10:35:22.234Z",
      "dateUpdated": "2025-06-16T10:44:34.571Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs-embeddedfinance.embedly.ng/llms.txt

Use this file to discover all available pages before exploring further.

​
Get All Virtual Wallets (Organization Business)

​
orgId
string
required
The unique identifier of your organization.
Example: 299b88c8-b13c-4336-8ed6-2ff4ab3e7f49
​
businessId
string
required
The unique identifier of your business unit under the organization.
Example: 877a95dc-c524-41aa-9a3e-c8ef3b849a21
​
label
string
Filter wallets by label (custom name).
Example: Vendor Wallet
​
startDate
string
Filter wallets created after this date (ISO 8601 format).
Example: 2025-06-01
​
endDate
string
Filter wallets created before this date (ISO 8601 format).
Example: 2025-06-30
​
isFrozen
boolean
Filter wallets by frozen status.
Example: true
​
page
number
default:"1"
The page number of results to return.
Example: 1
​
limit
number
default:"10"
The number of results to return per page.
Example: 10
{
  "data": [
    {
      "id": "string",
      "orgId": "string",
      "businessId": "string",
      "accountNumber": "1234567890",
      "bankCode": "999999",
      "type": "virtual",
      "isFrozen": true,
      "isExpired": false,
      "status": true,
      "expiresAt": null,
      "reason": null,
      "label": "Vendor Payout Wallet",
      "accountName": "Vendor Payout Wallet",
      "dateCreated": "2025-06-16T10:35:22.234Z",
      "dateUpdated": "2025-06-16T10:44:34.571Z"
    }
  ]
}