Get Card Balance

GET /api/v1/cards//balance - Retrieve current card balance

GET /api/v1/cards/{card_id}/balance

Get Card Balance

cURL

curl --request GET \
  --url https://api.usezentra.com/api/v1/cards/{card_id}/balance \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.usezentra.com/api/v1/cards/{card_id}/balance"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.usezentra.com/api/v1/cards/{card_id}/balance', 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://api.usezentra.com/api/v1/cards/{card_id}/balance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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://api.usezentra.com/api/v1/cards/{card_id}/balance"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.usezentra.com/api/v1/cards/{card_id}/balance")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.usezentra.com/api/v1/cards/{card_id}/balance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

Fetch the current available balance for a card.

Endpoint

GET /api/v1/cards/{card_id}/balance

Path Parameters

card_id · string · required

The card identifier returned during card creation or listing.

Example Request

curl https://api.usezentra.com/api/v1/cards/card_123/balance \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

Response Notes

• Balance values should be treated as minor units unless your integration-specific payload states otherwise.
• Use this endpoint when you need the current card balance, not the funding transaction history.

Next Steps

Funding History

Review historical card funding events

Fund Card

Add more balance to the card