Quick Reads

const url = new URL('https://panel.example.com/api/v1/admin/clients/search');
url.searchParams.set('q', 'acme');

const res  = await fetch(url, { headers: { Authorization: `Bearer ${apiKey}` } });
const body = await res.json();

$url = 'https://panel.example.com/api/v1/admin/clients/search?' . http_build_query(['q' => 'acme']);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);

$response = Api::Clients()->SearchClients([], ['q' => 'acme']);

const url = new URL('https://panel.example.com/api/v1/admin/clients/stats');
url.searchParams.set('period', 'month');

const res  = await fetch(url, { headers: { Authorization: `Bearer ${apiKey}` } });
const body = await res.json();

$url = 'https://panel.example.com/api/v1/admin/clients/stats?' . http_build_query(['period' => 'month']);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);

$response = Api::Clients()->GetClientsStats([], ['period' => 'month']);

const res  = await fetch('https://panel.example.com/api/v1/admin/clients/42/summary', {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();

$ch = curl_init('https://panel.example.com/api/v1/admin/clients/42/summary');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);

$response = Api::Clients()->GetClientSummary(['id' => 42]);

// The parts tell you where the score came from.
$score = $response['data']['trust_score'];
$fromServices = $score['services'];

const res  = await fetch('https://panel.example.com/api/v1/admin/clients/42/latest-note', {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();

// With no notes at all, data comes back null - not a 404.
if (body.data === null) return;

$ch = curl_init('https://panel.example.com/api/v1/admin/clients/42/latest-note');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);

$response = Api::Clients()->GetClientLatestNote(['id' => 42]);

// On a client with no notes, 'data' is null.
$note = $response['data'] ?? null;

const query = new URLSearchParams({ search: 'login', limit: '50' });
const res   = await fetch(`https://panel.example.com/api/v1/admin/clients/42/activity?${query}`, {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();

// meta.next_page is 0 on the last page.
const more = body.meta.next_page !== 0;

$query = http_build_query(['date' => '2026-10-01', 'date_op' => 'gte', 'limit' => 50]);
$ch    = curl_init('https://panel.example.com/api/v1/admin/clients/42/activity?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);

$response = Api::Clients()->GetClientActivity(['id' => 42], ['search' => 'login', 'limit' => 50]);

foreach ($response['data'] ?? [] as $row)
    echo $row['created_at'], ' ', $row['description'], PHP_EOL;

const res  = await fetch('https://panel.example.com/api/v1/admin/clients/42/messages?search=invoice', {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();

// The list has no body: keep type + id to read one message later.
const refs = body.data.map(m => ({ type: m.type, id: m.id }));

$query = http_build_query(['search' => 'invoice', 'page' => 2]);
$ch    = curl_init('https://panel.example.com/api/v1/admin/clients/42/messages?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);

$response = Api::Clients()->GetClientMessages(['id' => 42], ['date' => '2026-10-01 - 2026-10-12']);

// Read one body through the preview endpoint, with type + id from the list.
$first   = $response['data'][0] ?? null;
$preview = $first ? Api::Clients()->GetMessagePreview([], ['type' => $first['type'], 'id' => $first['id']]) : null;

const res  = await fetch('https://panel.example.com/api/v1/admin/clients/42/statement?currency=USD&period=last-year', {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();

// Positive means the client owes, negative means the client is in credit.
const owes = body.data.closing > 0;

$query = http_build_query(['currency' => 'USD', 'period' => 'custom', 'from' => '2026-01-01', 'to' => '2026-06-30']);
$ch    = curl_init('https://panel.example.com/api/v1/admin/clients/42/statement?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);

$response = Api::Clients()->GetClientStatement(['id' => 42], ['period' => 'all']);

// One statement per currency: walk the currencies the first answer lists.
foreach ($response['data']['currencies'] ?? [] as $currency) {
    $statement = Api::Clients()->GetClientStatement(['id' => 42], ['currency' => $currency['code'], 'period' => 'all']);
}