Freeze Wallet
curl --request POST \
--url https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze \
--header 'x-api-key: <api-key>'import requests
url = "https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze"
headers = {"x-api-key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};
fetch('https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze', 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://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
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://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze"
req, _ := http.NewRequest("POST", 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.post("https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": "e4b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
"customer_reference": "user_987",
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"label": "John Doe — School Fees",
"account_number": "2211334455",
"bank_name": "Nomba MFB",
"account_name": "PropTech Inc / John Doe",
"balance": 1500000,
"currency": "NGN",
"status": "FROZEN",
"system_prompt": "This wallet collects school fees...",
"allow_transfers_out": true,
"sub_account_id": null,
"created_at": "2026-07-01T11:00:00Z"
}
}
Wallets
Freeze Wallet
Temporarily freeze a wallet. Incoming payments will go to Suspense until unfrozen.
POST
/
v1
/
wallets
/
:wallet_id
/
freeze
Freeze Wallet
curl --request POST \
--url https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze \
--header 'x-api-key: <api-key>'import requests
url = "https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze"
headers = {"x-api-key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};
fetch('https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze', 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://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
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://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze"
req, _ := http.NewRequest("POST", 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.post("https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://johnajayi-avenue.hf.space/v1/wallets/:wallet_id/freeze")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": "e4b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
"customer_reference": "user_987",
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"label": "John Doe — School Fees",
"account_number": "2211334455",
"bank_name": "Nomba MFB",
"account_name": "PropTech Inc / John Doe",
"balance": 1500000,
"currency": "NGN",
"status": "FROZEN",
"system_prompt": "This wallet collects school fees...",
"allow_transfers_out": true,
"sub_account_id": null,
"created_at": "2026-07-01T11:00:00Z"
}
}
Request Headers
string
required
Your live or test API key.
Path Parameters
string
required
The Avenue wallet ID.
Response
All amounts and balances in this endpoint are represented in kobo (e.g.,
500000 = ₦5,000.00). Ensure you do not send or expect Naira values.{
"success": true,
"data": {
"id": "e4b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
"customer_reference": "user_987",
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"label": "John Doe — School Fees",
"account_number": "2211334455",
"bank_name": "Nomba MFB",
"account_name": "PropTech Inc / John Doe",
"balance": 1500000,
"currency": "NGN",
"status": "FROZEN",
"system_prompt": "This wallet collects school fees...",
"allow_transfers_out": true,
"sub_account_id": null,
"created_at": "2026-07-01T11:00:00Z"
}
}
Was this page helpful?