from metrifox_sdk import MetrifoxClient

client = MetrifoxClient(api_key="your_api_key")

# Get billing history for a subscription
subscription_id = "625f5cee-259b-4994-b7eb-416b9e551f2c"
response = client.subscriptions.get_billing_history(subscription_id)

for invoice in response['data']:
    print(f"Invoice: {invoice['invoice_number'] or 'Draft'}")
    print(f"  Amount: {invoice['currency']} {invoice['total_amount']}")
    print(f"  Status: {invoice['status']}")
    print(f"  Due: {invoice['due_date']}")
    print(f"  Source: {invoice['source_type']}")

import { init } from "metrifox-js";

const metrifoxClient = init({
  apiKey: process.env.METRIFOX_API_KEY
});

// Get billing history for a subscription
const subscriptionId = "625f5cee-259b-4994-b7eb-416b9e551f2c";
const response = await metrifoxClient.subscriptions.getBillingHistory(subscriptionId);

response.data.forEach(invoice => {
  console.log(`Invoice: ${invoice.invoice_number || 'Draft'}`);
  console.log(`  Amount: ${invoice.currency} ${invoice.total_amount}`);
  console.log(`  Status: ${invoice.status}`);
  console.log(`  Due: ${invoice.due_date}`);
  console.log(`  Source: ${invoice.source_type}`);
});

require 'metrifox-sdk'

# Initialize with configuration
METRIFOX_SDK = MetrifoxSDK.init({ api_key: "your-api-key" })

# Get billing history for a subscription
subscription_id = "625f5cee-259b-4994-b7eb-416b9e551f2c"
response = METRIFOX_SDK.subscriptions.get_billing_history(subscription_id)

response['data'].each do |invoice|
  puts "Invoice: #{invoice['invoice_number'] || 'Draft'}"
  puts "  Amount: #{invoice['currency']} #{invoice['total_amount']}"
  puts "  Status: #{invoice['status']}"
  puts "  Due: #{invoice['due_date']}"
  puts "  Source: #{invoice['source_type']}"
end

curl --request GET \
  --url https://{defaultHost}/api/v1/subscriptions/{subscription_id}/billing-history \
  --header 'x-api-key: <api-key>'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{defaultHost}/api/v1/subscriptions/{subscription_id}/billing-history",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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://{defaultHost}/api/v1/subscriptions/{subscription_id}/billing-history"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://{defaultHost}/api/v1/subscriptions/{subscription_id}/billing-history")
  .header("x-api-key", "<api-key>")
  .asString();

{
  "statusCode": 200,
  "message": "Billing history fetched successfully",
  "meta": {},
  "data": [
    {
      "invoice_id": "0d9e5a0e-7de4-48c6-b01a-b1759394578b",
      "invoice_number": null,
      "issued_date": "2026-03-12T16:55:21.847Z",
      "due_date": "2026-04-01T23:59:59.999Z",
      "total_amount": 21,
      "amount_paid": 0,
      "balance_due": 21,
      "currency": "USD",
      "status": "draft",
      "payment_method": null,
      "source_type": "billing_cycle",
      "created_at": "2026-02-13T13:01:32.715Z"
    },
    {
      "invoice_id": "762d8b5f-e416-4d88-8461-2a357b91ff25",
      "invoice_number": "INV027",
      "issued_date": "2026-02-13T13:01:01.520Z",
      "due_date": "2026-03-05T23:59:59.999Z",
      "total_amount": -23.0356,
      "amount_paid": 0,
      "balance_due": -23.0356,
      "currency": "USD",
      "status": "paid",
      "payment_method": null,
      "source_type": "order",
      "created_at": "2026-02-13T13:01:02.598Z"
    }
  ],
  "errors": {}
}

{
  "message": "<string>",
  "errors": {}
}

{
  "statusCode": 404,
  "message": "Subscription not found",
  "errors": {
    "subscription_id": [
      "Subscription with ID '625f5cee-259b-4994-b7eb-416b9e551f2c' does not exist"
    ]
  }
}