Quickstart

curl https://givebear.io/api/v1/organization \
  -H "Authorization: Bearer $GIVEBEAR_TOKEN"

// npm install @givebear/connect
import { GivebearConnect } from "@givebear/connect";

const gb = new GivebearConnect({ token: process.env.GIVEBEAR_TOKEN! });

const org = await gb.organization.get();
console.log(org.name);

# pip install requests
import os
import requests

headers = {"Authorization": f"Bearer {os.environ['GIVEBEAR_TOKEN']}"}

org = requests.get(
    "https://givebear.io/api/v1/organization", headers=headers
).json()
print(org["name"])

<?php
$token = getenv("GIVEBEAR_TOKEN");

$ch = curl_init("https://givebear.io/api/v1/organization");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $token"]);
$org = json_decode(curl_exec($ch), true);
curl_close($ch);

echo $org["name"];

require "net/http"
require "json"

uri = URI("https://givebear.io/api/v1/organization")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("GIVEBEAR_TOKEN")}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.parse(response.body)["name"]

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://givebear.io/api/v1/organization", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("GIVEBEAR_TOKEN"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var org struct {
		Name string `json:"name"`
	}
	json.NewDecoder(resp.Body).Decode(&org)
	fmt.Println(org.Name)
}

curl "https://givebear.io/api/v1/donations?limit=10" \
  -H "Authorization: Bearer $GIVEBEAR_TOKEN"

const { data, has_more, next_cursor } = await gb.donations.list({ limit: 10 });
console.log(data.length, has_more, next_cursor);

page = requests.get(
    "https://givebear.io/api/v1/donations",
    headers=headers,
    params={"limit": 10},
).json()
print(len(page["data"]), page["has_more"], page["next_cursor"])

$ch = curl_init("https://givebear.io/api/v1/donations?limit=10");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $token"]);
$page = json_decode(curl_exec($ch), true);
curl_close($ch);

echo count($page["data"]), " ", $page["has_more"] ? "true" : "false";

uri = URI("https://givebear.io/api/v1/donations?limit=10")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("GIVEBEAR_TOKEN")}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
page = JSON.parse(response.body)
puts page["data"].length, page["has_more"]

req, _ := http.NewRequest("GET", "https://givebear.io/api/v1/donations?limit=10", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("GIVEBEAR_TOKEN"))

resp, err := http.DefaultClient.Do(req)
if err != nil {
	panic(err)
}
defer resp.Body.Close()

var page struct {
	Data       []map[string]any `json:"data"`
	HasMore    bool             `json:"has_more"`
	NextCursor *string          `json:"next_cursor"`
}
json.NewDecoder(resp.Body).Decode(&page)
fmt.Println(len(page.Data), page.HasMore)

curl "https://givebear.io/api/v1/donations?limit=10&cursor=eyJ..." \
  -H "Authorization: Bearer $GIVEBEAR_TOKEN"

curl "https://givebear.io/api/v1/donations?updated_since=2026-01-01T00:00:00Z" \
  -H "Authorization: Bearer $GIVEBEAR_TOKEN"

// listAll walks every page for you with an async iterator.
for await (const donation of gb.donations.listAll({
  updated_since: "2026-01-01T00:00:00Z",
})) {
  console.log(donation.amount_cents, donation.donor_email);
}

params = {"limit": 10, "updated_since": "2026-01-01T00:00:00Z"}
while True:
    page = requests.get(
        "https://givebear.io/api/v1/donations", headers=headers, params=params
    ).json()
    for donation in page["data"]:
        print(donation["amount_cents"], donation["donor_email"])
    if not page["has_more"]:
        break
    params["cursor"] = page["next_cursor"]

$query = ["limit" => 10, "updated_since" => "2026-01-01T00:00:00Z"];
do {
    $url = "https://givebear.io/api/v1/donations?" . http_build_query($query);
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $token"]);
    $page = json_decode(curl_exec($ch), true);
    curl_close($ch);

    foreach ($page["data"] as $donation) {
        echo $donation["amount_cents"], " ", $donation["donor_email"], "\n";
    }
    $query["cursor"] = $page["next_cursor"];
} while ($page["has_more"]);

params = { limit: 10, updated_since: "2026-01-01T00:00:00Z" }
loop do
  uri = URI("https://givebear.io/api/v1/donations")
  uri.query = URI.encode_www_form(params)
  request = Net::HTTP::Get.new(uri)
  request["Authorization"] = "Bearer #{ENV.fetch("GIVEBEAR_TOKEN")}"

  response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
    http.request(request)
  end
  page = JSON.parse(response.body)

  page["data"].each { |d| puts "#{d["amount_cents"]} #{d["donor_email"]}" }
  break unless page["has_more"]
  params[:cursor] = page["next_cursor"]
end

cursor := ""
for {
	url := "https://givebear.io/api/v1/donations?limit=10&updated_since=2026-01-01T00:00:00Z"
	if cursor != "" {
		url += "&cursor=" + cursor
	}
	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("GIVEBEAR_TOKEN"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	var page struct {
		Data []struct {
			AmountCents int    `json:"amount_cents"`
			DonorEmail  string `json:"donor_email"`
		} `json:"data"`
		HasMore    bool   `json:"has_more"`
		NextCursor string `json:"next_cursor"`
	}
	json.NewDecoder(resp.Body).Decode(&page)
	resp.Body.Close()

	for _, d := range page.Data {
		fmt.Println(d.AmountCents, d.DonorEmail)
	}
	if !page.HasMore {
		break
	}
	cursor = page.NextCursor
}