Python SDK
from metrifox_sdk import MetrifoxClient
client = MetrifoxClient(api_key="your_api_key")
# List usage events with optional filters and pagination
events = client.usages.list_events(
customer_key="cust-6d11ca90",
feature_key="feature_job_posts",
page=1,
per_page=25,
)
for event in events['data']:
print(f"{event['feature_key']}: qty={event['quantity']} at {event['timestamp']}")
print(f"Page {events['meta']['current_page']} of {events['meta']['total_pages']}")import { init } from "metrifox-js";
const metrifoxClient = init({
apiKey: process.env.METRIFOX_API_KEY
});
const events = await metrifoxClient.usages.listEvents({
customerKey: "cust-6d11ca90",
featureKey: "feature_job_posts",
page: 1,
perPage: 25,
});
events.data.forEach((e) => {
console.log(`${e.feature_key}: qty=${e.quantity} at ${e.timestamp}`);
});
console.log(`Page ${events.meta.current_page} of ${events.meta.total_pages}`);
require 'metrifox-sdk'
METRIFOX_SDK = MetrifoxSDK.init({ api_key: "your-api-key" })
response = METRIFOX_SDK.usages.list_events(
customer_key: "cust-6d11ca90",
feature_key: "feature_job_posts",
page: 1,
per_page: 25
)
response["data"].each do |event|
puts "#{event['feature_key']}: qty=#{event['quantity']} at #{event['timestamp']}"
end
curl --request GET \
--url https://api-meter.metrifox.com/usage/events \
--header 'x-api-key: <api-key>'<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-meter.metrifox.com/usage/events",
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://api-meter.metrifox.com/usage/events"
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://api-meter.metrifox.com/usage/events")
.header("x-api-key", "<api-key>")
.asString();{
"data": [
{
"metadata": {},
"id": "92878f67-b956-4852-8b12-fde3c88fc94d",
"credit_used": null,
"event_id": 234567340178,
"timestamp": 1765306708000,
"event_name": null,
"feature_key": "feature_job_posts",
"customer_key": "cust-mit7k5v8obzs",
"quantity": 1
},
{
"metadata": {},
"id": "9be6a05e-dbfa-4455-84f6-b5bb0cebd847",
"credit_used": null,
"event_id": 23456734012378,
"timestamp": 1765206678000,
"event_name": null,
"feature_key": "feature_seats",
"customer_key": "cust-mit7k5v8obzs",
"quantity": -1
},
{
"metadata": {},
"id": "3fd7437d-6d6c-4c1c-a430-4da4f7d5aa71",
"credit_used": null,
"event_id": 23456785012378,
"timestamp": 1765206295000,
"event_name": null,
"feature_key": "feature_payroll",
"customer_key": "cust-mit7k5v8obzs",
"quantity": 1
}
]
}{
"message": "Unauthorized"
}Usage
Get All Usage Events
Fetches a paginated list of usage events. Pagination is automatically applied even if no page parameters are provided.
GET
/
usage
/
events
Python SDK
from metrifox_sdk import MetrifoxClient
client = MetrifoxClient(api_key="your_api_key")
# List usage events with optional filters and pagination
events = client.usages.list_events(
customer_key="cust-6d11ca90",
feature_key="feature_job_posts",
page=1,
per_page=25,
)
for event in events['data']:
print(f"{event['feature_key']}: qty={event['quantity']} at {event['timestamp']}")
print(f"Page {events['meta']['current_page']} of {events['meta']['total_pages']}")import { init } from "metrifox-js";
const metrifoxClient = init({
apiKey: process.env.METRIFOX_API_KEY
});
const events = await metrifoxClient.usages.listEvents({
customerKey: "cust-6d11ca90",
featureKey: "feature_job_posts",
page: 1,
perPage: 25,
});
events.data.forEach((e) => {
console.log(`${e.feature_key}: qty=${e.quantity} at ${e.timestamp}`);
});
console.log(`Page ${events.meta.current_page} of ${events.meta.total_pages}`);
require 'metrifox-sdk'
METRIFOX_SDK = MetrifoxSDK.init({ api_key: "your-api-key" })
response = METRIFOX_SDK.usages.list_events(
customer_key: "cust-6d11ca90",
feature_key: "feature_job_posts",
page: 1,
per_page: 25
)
response["data"].each do |event|
puts "#{event['feature_key']}: qty=#{event['quantity']} at #{event['timestamp']}"
end
curl --request GET \
--url https://api-meter.metrifox.com/usage/events \
--header 'x-api-key: <api-key>'<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-meter.metrifox.com/usage/events",
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://api-meter.metrifox.com/usage/events"
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://api-meter.metrifox.com/usage/events")
.header("x-api-key", "<api-key>")
.asString();{
"data": [
{
"metadata": {},
"id": "92878f67-b956-4852-8b12-fde3c88fc94d",
"credit_used": null,
"event_id": 234567340178,
"timestamp": 1765306708000,
"event_name": null,
"feature_key": "feature_job_posts",
"customer_key": "cust-mit7k5v8obzs",
"quantity": 1
},
{
"metadata": {},
"id": "9be6a05e-dbfa-4455-84f6-b5bb0cebd847",
"credit_used": null,
"event_id": 23456734012378,
"timestamp": 1765206678000,
"event_name": null,
"feature_key": "feature_seats",
"customer_key": "cust-mit7k5v8obzs",
"quantity": -1
},
{
"metadata": {},
"id": "3fd7437d-6d6c-4c1c-a430-4da4f7d5aa71",
"credit_used": null,
"event_id": 23456785012378,
"timestamp": 1765206295000,
"event_name": null,
"feature_key": "feature_payroll",
"customer_key": "cust-mit7k5v8obzs",
"quantity": 1
}
]
}{
"message": "Unauthorized"
}Usage endpoints are served from https://api-meter.metrifox.com. Other API calls stay on https://api.metrifox.com.
Authorizations
Query Parameters
Page number (starts from 1)
Number of records per page
Filter events by customer key
Filter events by event name (deprecated, use feature_key)
Filter events by feature key
Response
Events fetched
Show child attributes
Show child attributes
⌘I

