import { MailChannels } from "mailchannels-sdk";

const { PARENT_API_KEY, SUB_ACCOUNT_HANDLE } = process.env;
if (!PARENT_API_KEY) throw new Error("Set PARENT_API_KEY (a parent-account API key) before running");
if (!SUB_ACCOUNT_HANDLE) throw new Error("Set SUB_ACCOUNT_HANDLE (the sub-account to query)");

const mailchannels = new MailChannels(PARENT_API_KEY);

const { data, error } = await mailchannels.subAccounts.getUsage(SUB_ACCOUNT_HANDLE);

if (error) {
  console.error("Get sub-account usage failed:", error);
  process.exit(1);
}
console.log(data);

import os
import sys

import mailchannels

parent_api_key = os.environ.get("PARENT_API_KEY")
handle = os.environ.get("SUB_ACCOUNT_HANDLE")
if not parent_api_key:
    sys.exit("Set PARENT_API_KEY (a parent-account API key) before running")
if not handle:
    sys.exit("Set SUB_ACCOUNT_HANDLE (the sub-account to query)")

mailchannels.api_key = parent_api_key

response = mailchannels.SubAccounts.retrieve_usage(handle)

print(response)

<?php

require_once __DIR__ . '/vendor/autoload.php';

use MailChannels\Client;

$parent_api_key     = getenv('PARENT_API_KEY') or exit("Error: PARENT_API_KEY is not set\n");
$sub_account_handle = getenv('SUB_ACCOUNT_HANDLE') or exit("Error: SUB_ACCOUNT_HANDLE is not set\n");

$client = new Client(apiKey: $parent_api_key);

$response = $client->subAccounts->retrieveUsage($sub_account_handle);

print_r($response->toArray());

curl --request GET \
  --url https://api.mailchannels.net/tx/v1/sub-account/{handle}/usage \
  --header 'X-Api-Key: <x-api-key>'

{
  "monthly_limit": 10000,
  "total_usage": 5000,
  "period_end_date": "2025-04-11",
  "period_start_date": "2025-03-12"
}