Skip to main content
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']}")
{
  "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
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.metrifox.com/llms.txt

Use this file to discover all available pages before exploring further.

Usage endpoints are served from https://api-meter.metrifox.com. Other API calls stay on https://api.metrifox.com.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
page
integer
default:1

Page number (starts from 1)

​
per_page
integer
default:25

Number of records per page

​
customer_key
string

Filter events by customer key

​
event_name
string

Filter events by event name (deprecated, use feature_key)

​
feature_key
string

Filter events by feature key

Response

Events fetched

​
data
object[]