Get account
curl --request GET \
--url https://catchbackcards.com/api/partner/v1/account \
--header 'Authorization: Bearer <token>'import requests
url = "https://catchbackcards.com/api/partner/v1/account"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://catchbackcards.com/api/partner/v1/account', 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://catchbackcards.com/api/partner/v1/account",
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://catchbackcards.com/api/partner/v1/account"
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://catchbackcards.com/api/partner/v1/account")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://catchbackcards.com/api/partner/v1/account")
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{
"username": "acme-cards",
"balance": 189953.5,
"limits": {
"packs_today": 4,
"max_packs_per_day": 100,
"packs_left_today": 96,
"resets_at": "2026-09-30T00:00:00.000Z",
"min_seconds_between_purchases": 60,
"next_purchase_at": "2026-09-29T20:24:12.000Z"
},
"card_limits": {
"cards_today": 3,
"max_cards_per_day": 25,
"cards_left_today": 22,
"spend_today": 4353,
"max_card_spend_per_day": 50000,
"spend_left_today": 45647,
"resets_at": "2026-09-30T00:00:00.000Z"
}
}{
"error": "Missing or malformed API key"
}{
"error": "<string>",
"code": "<string>"
}Account
Get account
Scope: read:account (needs a linked account).
Your CatchCoins balance, packs used today against the daily ceiling, when the next pack purchase is allowed, and cards and card spend used today against the daily caps.
GET
/
api
/
partner
/
v1
/
account
Get account
curl --request GET \
--url https://catchbackcards.com/api/partner/v1/account \
--header 'Authorization: Bearer <token>'import requests
url = "https://catchbackcards.com/api/partner/v1/account"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://catchbackcards.com/api/partner/v1/account', 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://catchbackcards.com/api/partner/v1/account",
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://catchbackcards.com/api/partner/v1/account"
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://catchbackcards.com/api/partner/v1/account")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://catchbackcards.com/api/partner/v1/account")
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{
"username": "acme-cards",
"balance": 189953.5,
"limits": {
"packs_today": 4,
"max_packs_per_day": 100,
"packs_left_today": 96,
"resets_at": "2026-09-30T00:00:00.000Z",
"min_seconds_between_purchases": 60,
"next_purchase_at": "2026-09-29T20:24:12.000Z"
},
"card_limits": {
"cards_today": 3,
"max_cards_per_day": 25,
"cards_left_today": 22,
"spend_today": 4353,
"max_card_spend_per_day": 50000,
"spend_left_today": 45647,
"resets_at": "2026-09-30T00:00:00.000Z"
}
}{
"error": "Missing or malformed API key"
}{
"error": "<string>",
"code": "<string>"
}Authorizations
Your API key, sent as a bearer token. Keep it on your server. See Authentication. A request from a location we refuse gets a 403 with Access denied, whether or not it has a valid key: where you can call from.
Response
The balance and limits.
Pack limits. packs_today and packs_left_today are null if we can't count them just then.
Show child attributes
Show child attributes
Card limits. The usage fields are null if we can't count them just then.
Show child attributes
Show child attributes