Get Wallet By ID

GET /api-access/purses/wallets/{id}

Get a specific wallet by ID.

Authentication

Required Headers:

Authorization: HMAC-SHA256 PUBLIC_KEY:PRIVATE_KEY
X-Origin: third-party-api
X-Timestamp: 2025-10-12T14:30:00.000Z
Content-Type: application/json

Request

Path Parameters:

Parameter	Type	Required	Description
id	string	Yes	Wallet ID

Response

Success Response (200):

{
  "data": {
    "id": "string",
    "balance": 0,
    "walletName": "string",
    "currency": {
      "currencyCode": "string",
      "numericCode": 0,
      "numericCodeAsString": "string",
      "displayName": "string",
      "symbol": "string",
      "defaultFractionDigits": 0
    },
    "description": "string",
    "businessId": "string",
    "userId": "string",
    "walletType": "BankWallet",
    "status": "ACTIVE",
    "walletReference": "string",
    "createdAt": "2025-10-15T18:54:39.076Z",
    "updatedAt": "2025-10-15T18:54:39.076Z"
  },
  "success": true,
  "message": "string",
  "detail": "string"
}

Response Fields:

Field	Type	Description
id	string	Wallet ID
balance	number	Wallet balance
walletName	string	Wallet name
currency	object	Currency details object
currency.currencyCode	string	Currency code (e.g., XOF, USD)
currency.numericCode	number	ISO numeric currency code
currency.numericCodeAsString	string	ISO numeric currency code as string
currency.displayName	string	Display name of currency
currency.symbol	string	Currency symbol
currency.defaultFractionDigits	number	Default decimal places
description	string	Wallet description
businessId	string	Business ID
userId	string	User ID
walletType	string	Wallet type (e.g., BankWallet, MobileMoneyWallet)
status	string	Wallet status (e.g., ACTIVE)
walletReference	string	Wallet reference
createdAt	string	Timestamp when wallet was created (ISO 8601)
updatedAt	string	Timestamp when wallet was last updated (ISO 8601)

Example

cURL

curl -X GET "https://sandbox.mara.boo/api-access/purses/wallets/{id}" \
  -H "Authorization: HMAC-SHA256 YOUR_PUBLIC_KEY:YOUR_PRIVATE_KEY" \
  -H "X-Origin: third-party-api" \
  -H "X-Timestamp: 2025-10-12T14:30:00.000Z" \
  -H "Content-Type: application/json"

JavaScript

const response = await fetch('https://sandbox.mara.boo/api-access/purses/wallets/{id}', {
  method: 'GET',
  headers: {
    'Authorization': 'HMAC-SHA256 YOUR_PUBLIC_KEY:YOUR_PRIVATE_KEY',
    'X-Origin': 'third-party-api',
    'X-Timestamp': '2025-10-12T14:30:00.000Z',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();

Python

import requests

response = requests.get(
    'https://sandbox.mara.boo/api-access/purses/wallets/{id}',
    headers={
        'Authorization': 'HMAC-SHA256 YOUR_PUBLIC_KEY:YOUR_PRIVATE_KEY',
        'X-Origin': 'third-party-api',
        'X-Timestamp': '2025-10-12T14:30:00.000Z',
        'Content-Type': 'application/json'
    }
)

data = response.json()

Go

package main

import (
    "net/http"
    "io/ioutil"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://sandbox.mara.boo/api-access/purses/wallets/{id}", nil)

    req.Header.Set("Authorization", "HMAC-SHA256 YOUR_PUBLIC_KEY:YOUR_PRIVATE_KEY")
    req.Header.Set("X-Origin", "third-party-api")
    req.Header.Set("X-Timestamp", "2025-10-12T14:30:00.000Z")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
}

Java

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://sandbox.mara.boo/api-access/purses/wallets/{id}"))
    .header("Authorization", "HMAC-SHA256 YOUR_PUBLIC_KEY:YOUR_PRIVATE_KEY")
    .header("X-Origin", "third-party-api")
    .header("X-Timestamp", "2025-10-12T14:30:00.000Z")
    .header("Content-Type", "application/json")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

C#

using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://sandbox.mara.boo/api-access/purses/wallets/{id}");

request.Headers.Add("Authorization", "HMAC-SHA256 YOUR_PUBLIC_KEY:YOUR_PRIVATE_KEY");
request.Headers.Add("X-Origin", "third-party-api");
request.Headers.Add("X-Timestamp", "2025-10-12T14:30:00.000Z");
request.Content.Headers.ContentType = new MediaTypeHeaderValue("application/json");

var response = await client.SendAsync(request);
var content = await response.Content.ReadAsStringAsync();

Error Responses

Status Code	Description
401	Unauthorized - Invalid authentication
403	Forbidden - Missing required headers
404	Not Found - Wallet doesn't exist
500	Internal Server Error

Related

• Get Wallets
• Wallets Guide