RecurDesk API

import requests

BASE_URL = "https://api.recurdesk.com/api/v1"
API_KEY = "rdk_live_a1b2c3d4e5f6g7h8i9j0"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

# 1. List customers
resp = requests.get(f"{BASE_URL}/customers", headers=headers)
customers = resp.json()["data"]
print(f"Found {resp.json()['meta']['total']} customers")

# 2. Create a customer
new_customer = requests.post(
    f"{BASE_URL}/customers",
    headers=headers,
    json={
        "name": "Initech LLC",
        "email": "billing@initech.com",
        "currency_code": "USD",
    },
).json()
print(f"Created customer: {new_customer['id']}")

# 3. Record usage
usage = requests.post(
    f"{BASE_URL}/usage",
    headers=headers,
    json={
        "subscription_id": "sub_4d5e6f7a-8b9c-0d1e-2f3a-4b5c6d7e8f9a",
        "quantity": 1500,
        "description": "API calls - March 2026",
        "idempotency_key": "usage_2026-03-30_api-calls",
    },
).json()
print(f"Recorded usage: {usage['id']}")

# For async applications, consider using httpx:
# import httpx
# async with httpx.AsyncClient(base_url=BASE_URL, headers=headers) as client:
#     resp = await client.get("/customers")

using System.Net.Http.Headers;
using System.Net.Http.Json;
using System.Text.Json;

const string baseUrl = "https://api.recurdesk.com/api/v1";
const string apiKey = "rdk_live_a1b2c3d4e5f6g7h8i9j0";

using var client = new HttpClient();
client.BaseAddress = new Uri(baseUrl);
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", apiKey);

// 1. List customers
var listResp = await client.GetAsync("/customers");
var listJson = await listResp.Content.ReadFromJsonAsync<JsonElement>();
var total = listJson.GetProperty("meta").GetProperty("total").GetInt32();
Console.WriteLine($"Found {total} customers");

// 2. Create a customer
var createResp = await client.PostAsJsonAsync("/customers", new
{
    name = "Initech LLC",
    email = "billing@initech.com",
    currency_code = "USD"
});
var created = await createResp.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine($"Created customer: {created.GetProperty("id")}");

// 3. Record usage
var usageResp = await client.PostAsJsonAsync("/usage", new
{
    subscription_id = "sub_4d5e6f7a-8b9c-0d1e-2f3a-4b5c6d7e8f9a",
    quantity = 1500,
    description = "API calls - March 2026",
    idempotency_key = "usage_2026-03-30_api-calls"
});
var usage = await usageResp.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine($"Recorded usage: {usage.GetProperty("id")}");

const BASE_URL = "https://api.recurdesk.com/api/v1";
const API_KEY = "rdk_live_a1b2c3d4e5f6g7h8i9j0";

const headers = {
  Authorization: `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};

// 1. List customers
const listResp = await fetch(`${BASE_URL}/customers`, { headers });
const { data: customers, meta } = await listResp.json();
console.log(`Found ${meta.total} customers`);

// 2. Create a customer
const createResp = await fetch(`${BASE_URL}/customers`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    name: "Initech LLC",
    email: "billing@initech.com",
    currency_code: "USD",
  }),
});
const newCustomer = await createResp.json();
console.log(`Created customer: ${newCustomer.id}`);

// 3. Record usage
const usageResp = await fetch(`${BASE_URL}/usage`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    subscription_id: "sub_4d5e6f7a-8b9c-0d1e-2f3a-4b5c6d7e8f9a",
    quantity: 1500,
    description: "API calls - March 2026",
    idempotency_key: "usage_2026-03-30_api-calls",
  }),
});
const usage = await usageResp.json();
console.log(`Recorded usage: ${usage.id}`);

<?php

$baseUrl = "https://api.recurdesk.com/api/v1";
$apiKey  = "rdk_live_a1b2c3d4e5f6g7h8i9j0";

function apiRequest(string $method, string $url, ?array $body = null): array {
    global $apiKey;
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            "Authorization: Bearer $apiKey",
            "Content-Type: application/json",
        ],
    ]);
    if ($method === "POST") {
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
    }
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

// 1. List customers
$list = apiRequest("GET", "$baseUrl/customers");
echo "Found {$list['meta']['total']} customers\n";

// 2. Create a customer
$created = apiRequest("POST", "$baseUrl/customers", [
    "name"          => "Initech LLC",
    "email"         => "billing@initech.com",
    "currency_code" => "USD",
]);
echo "Created customer: {$created['id']}\n";

// 3. Record usage
$usage = apiRequest("POST", "$baseUrl/usage", [
    "subscription_id" => "sub_4d5e6f7a-8b9c-0d1e-2f3a-4b5c6d7e8f9a",
    "quantity"         => 1500,
    "description"      => "API calls - March 2026",
    "idempotency_key"  => "usage_2026-03-30_api-calls",
]);
echo "Recorded usage: {$usage['id']}\n";

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

const (
	baseURL = "https://api.recurdesk.com/api/v1"
	apiKey  = "rdk_live_a1b2c3d4e5f6g7h8i9j0"
)

func apiRequest(method, path string, body any) (map[string]any, error) {
	var reqBody io.Reader
	if body != nil {
		b, _ := json.Marshal(body)
		reqBody = bytes.NewReader(b)
	}
	req, _ := http.NewRequest(method, baseURL+path, reqBody)
	req.Header.Set("Authorization", "Bearer "+apiKey)
	req.Header.Set("Content-Type", "application/json")

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

	var result map[string]any
	json.NewDecoder(resp.Body).Decode(&result)
	return result, nil
}

func main() {
	// 1. List customers
	list, _ := apiRequest("GET", "/customers", nil)
	meta := list["meta"].(map[string]any)
	fmt.Printf("Found %.0f customers\n", meta["total"])

	// 2. Create a customer
	created, _ := apiRequest("POST", "/customers", map[string]any{
		"name":          "Initech LLC",
		"email":         "billing@initech.com",
		"currency_code": "USD",
	})
	fmt.Printf("Created customer: %s\n", created["id"])

	// 3. Record usage
	usage, _ := apiRequest("POST", "/usage", map[string]any{
		"subscription_id": "sub_4d5e6f7a-8b9c-0d1e-2f3a-4b5c6d7e8f9a",
		"quantity":        1500,
		"description":     "API calls - March 2026",
		"idempotency_key": "usage_2026-03-30_api-calls",
	})
	fmt.Printf("Recorded usage: %s\n", usage["id"])
}