Skip to main content
GET
/
metrics
List billable metrics
curl --request GET \
  --url https://api.alguna.io/metrics \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "aggregation": {
        "field": "amount",
        "method": "sum"
      },
      "created_at": "2026-04-01T10:00:00Z",
      "event_name": "api_call",
      "id": "mtr_01H1VECT",
      "name": "API Calls",
      "updated_at": "2026-04-01T12:30:00Z",
      "description": "Counts API calls per customer",
      "filter_groups": [
        {
          "filters": [
            {
              "field": "region",
              "operator": "equal",
              "value": "us-east-1"
            }
          ],
          "operator": "and"
        }
      ],
      "tag_ids": [
        "<string>"
      ]
    }
  ],
  "pagination": {
    "per_page": 20,
    "total_pages": 5
  }
}

Documentation Index

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

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

Authorizations

Authorization
string
header
required

API key authentication. Pass your API key as a Bearer token.

Headers

Alguna-Version
enum<string>
required
Available options:
2026-04-01

Query Parameters

aggregation_field
string[]

Filter by aggregation field (comma-separated to match any)

Example:

"amount"

aggregation_method
enum<string>[]

Filter by aggregation method (comma-separated to match any)

Available options:
count,
count_unique,
average,
min,
max,
sum
Example:

"sum"

event_name
string[]

Filter by event name (comma-separated to match any)

Example:

"api_call"

limit
integer<int64>
required

Number of items to return per page

Example:

20

offset
integer<int64>
required

Number of items to skip

Example:

0

sort
string
required

Sort field and direction in format field:order

Example:

"name:asc"

tag_ids
string[]

Filter by tag IDs (comma-separated to match any)

Example:

"tag_abc123"

Response

Success

data
object[]
required

List of metrics

pagination
object
required

Pagination metadata