Ingest billable events

POST

events

curl --request POST \
  --url https://api.alguna.io/events \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "account": "cust_01H1VECT",
      "event_name": "api_call",
      "unique_id": "evt_abc123",
      "properties": {},
      "timestamp": "2026-04-01T10:00:00Z"
    }
  ]
}
'

{
  "failed": [
    "<string>"
  ],
  "ingested": [
    "<string>"
  ]
}

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

Body

application/json

events

object[]

required

Array of events to ingest. Maximum 100 events per request

Show child attributes

Response

Success

failed

string[]

required

List of unique_id values that failed to ingest

ingested

string[]

required

List of unique_id values that were successfully ingested

List billable metricsReturns a paginated list of billable metrics. Supports filtering by event name, aggregation method, aggregation field, and tag IDs. Results can be sorted by name.

⌘I

Ingest billable events

curl --request POST \
  --url https://api.alguna.io/events \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "account": "cust_01H1VECT",
      "event_name": "api_call",
      "unique_id": "evt_abc123",
      "properties": {},
      "timestamp": "2026-04-01T10:00:00Z"
    }
  ]
}
'

{
  "failed": [
    "<string>"
  ],
  "ingested": [
    "<string>"
  ]
}