API reference · Accounts & ledger

Wallets

Nested wallets on one customer, each with its own limits. About wallets Live

POST/walletOpen a wallet
DELETE/wallet/{reference}Close a wallet's underlying account
GET/wallet/{reference}Fetch a wallet by reference
PUT/wallet/{reference}Rename a wallet
POST/wallet/{reference}/freezeFreeze a wallet's underlying account
POST/wallet/{reference}/unfreezeUnfreeze a wallet's underlying account
GET/walletsList the caller's own wallets

POST Open a wallet

POST /wallet

Opens a wallet of the given wallet-flavored account type. If currencyCode is omitted, it is resolved from the caller's resident country's default supported currency.

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live
`Content-Type`	application/json

Example

Request body: WalletRequest · Response: WalletResponse

curl -X POST "https://api.bridgemoni.com/wallet" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ada Obi",
    "description": "March payroll",
    "walletType": "main",
    "currencyCode": "NGN"
  }'

{
  "name": "Ada Obi",
  "description": "March payroll",
  "walletType": "main",
  "currencyCode": "NGN"
}

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "name": "Ada Obi",
    "description": "March payroll",
    "walletType": "main",
    "currencyCode": "NGN",
    "accountNumber": "0123456789",
    "accountType": "main",
    "status": "active",
    "availableBalance": {
      "amount": "250000.00",
      "currencyCode": "NGN"
    },
    "reservedBalance": {
      "amount": "250000.00",
      "currencyCode": "NGN"
    },
    "accountReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "deviceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "creationDateTime": "2027-03-14T14:30:01"
  },
  "description": "Open a wallet"
}

Responses

Status	When
`200`	Wallet opened successfully

DELETE Close a wallet's underlying account

DELETE /wallet/{reference}

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Path parameters

Name
`reference`

Example

Response: WalletResponse

curl -X DELETE "https://api.bridgemoni.com/wallet/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "name": "Ada Obi",
    "description": "March payroll",
    "walletType": "main",
    "currencyCode": "NGN",
    "accountNumber": "0123456789",
    "accountType": "main",
    "status": "active",
    "availableBalance": {
      "amount": "250000.00",
      "currencyCode": "NGN"
    },
    "reservedBalance": {
      "amount": "250000.00",
      "currencyCode": "NGN"
    },
    "accountReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "deviceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "creationDateTime": "2027-03-14T14:30:01"
  },
  "description": "Close a wallet's underlying account"
}

Responses

Status	When
`200`	Wallet closed successfully

GET Fetch a wallet by reference

GET /wallet/{reference}

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Path parameters

Name
`reference`

Example

Response: WalletResponse

curl -X GET "https://api.bridgemoni.com/wallet/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "name": "Ada Obi",
    "description": "March payroll",
    "walletType": "main",
    "currencyCode": "NGN",
    "accountNumber": "0123456789",
    "accountType": "main",
    "status": "active",
    "availableBalance": {
      "amount": "250000.00",
      "currencyCode": "NGN"
    },
    "reservedBalance": {
      "amount": "250000.00",
      "currencyCode": "NGN"
    },
    "accountReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "deviceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "creationDateTime": "2027-03-14T14:30:01"
  },
  "description": "Fetch a wallet by reference"
}

Responses

Status	When
`200`	Wallet fetched successfully
`401`	The wallet does not belong to the caller
`404`	No wallet exists for the given reference

PUT Rename a wallet

PUT /wallet/{reference}

Renames the wallet's label. Balance and status are never editable directly.

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live
`Content-Type`	application/json

Path parameters

Name
`reference`

Example

Request body: UpdateWalletRequest · Response: WalletResponse

curl -X PUT "https://api.bridgemoni.com/wallet/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ada Obi"
  }'

{
  "name": "Ada Obi"
}

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "name": "Ada Obi",
    "description": "March payroll",
    "walletType": "main",
    "currencyCode": "NGN",
    "accountNumber": "0123456789",
    "accountType": "main",
    "status": "active",
    "availableBalance": {
      "amount": "250000.00",
      "currencyCode": "NGN"
    },
    "reservedBalance": {
      "amount": "250000.00",
      "currencyCode": "NGN"
    },
    "accountReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "deviceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "creationDateTime": "2027-03-14T14:30:01"
  },
  "description": "Rename a wallet"
}

Responses

Status	When
`200`	Wallet renamed successfully

POST Freeze a wallet's underlying account

POST /wallet/{reference}/freeze

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Path parameters

Name
`reference`

Example

Response: WalletResponse

curl -X POST "https://api.bridgemoni.com/wallet/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/freeze" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "name": "Ada Obi",
    "description": "March payroll",
    "walletType": "main",
    "currencyCode": "NGN",
    "accountNumber": "0123456789",
    "accountType": "main",
    "status": "active",
    "availableBalance": {
      "amount": "250000.00",
      "currencyCode": "NGN"
    },
    "reservedBalance": {
      "amount": "250000.00",
      "currencyCode": "NGN"
    },
    "accountReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "deviceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "creationDateTime": "2027-03-14T14:30:01"
  },
  "description": "Freeze a wallet's underlying account"
}

Responses

Status	When
`200`	Wallet frozen successfully

POST Unfreeze a wallet's underlying account

POST /wallet/{reference}/unfreeze

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Path parameters

Name
`reference`

Example

Response: WalletResponse

curl -X POST "https://api.bridgemoni.com/wallet/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/unfreeze" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "name": "Ada Obi",
    "description": "March payroll",
    "walletType": "main",
    "currencyCode": "NGN",
    "accountNumber": "0123456789",
    "accountType": "main",
    "status": "active",
    "availableBalance": {
      "amount": "250000.00",
      "currencyCode": "NGN"
    },
    "reservedBalance": {
      "amount": "250000.00",
      "currencyCode": "NGN"
    },
    "accountReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "deviceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "creationDateTime": "2027-03-14T14:30:01"
  },
  "description": "Unfreeze a wallet's underlying account"
}

Responses

Status	When
`200`	Wallet unfrozen successfully

GET List the caller's own wallets

GET /wallets

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Example

Response: List<WalletResponse>

curl -X GET "https://api.bridgemoni.com/wallets" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": [
    {
      "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "name": "Ada Obi",
      "description": "March payroll",
      "walletType": "main",
      "currencyCode": "NGN",
      "accountNumber": "0123456789",
      "accountType": "main",
      "status": "active",
      "availableBalance": {
        "amount": "250000.00",
        "currencyCode": "NGN"
      },
      "reservedBalance": {
        "amount": "250000.00",
        "currencyCode": "NGN"
      },
      "accountReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "deviceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "creationDateTime": "2027-03-14T14:30:01"
    }
  ],
  "description": "List the caller's own wallets"
}

Responses

Status	When
`200`	Wallets fetched successfully

Generated from the OpenAPI document. Branch on the HTTP status: there is no machine-readable error code on the wire. Errors