Report a usage event | Prolifi

curl -X POST https://api.prolifi.co/api/v1/public/events \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "customer_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "event_name": "api_calls",
  "subscription_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "timestamp": "2026-03-13T14:30:00Z",
  "properties": {
    "endpoint": "/v1/completions",
    "tokens": 150
  },
  "idempotency_key": "evt_unique_12345"
}'

{
  "data": {
    "id": "string",
    "customer_id": "string",
    "event_name": "string",
    "timestamp": "2024-01-15T09:30:00Z",
    "properties": {},
    "idempotency_key": "string",
    "created_at": "2024-01-15T09:30:00Z"
  }
}

Reports a single usage event for a customer. The event_name must match an active usage event definition configured for your account.

If no properties are provided, a default count: 1 property is added automatically.

Authentication

AuthorizationBearer

Use a secret key (sk_test_* or sk_live_*) for full read/write access, or a public key (pk_test_* or pk_live_*) for read-only access.

Request

This endpoint expects an object.

customer_idstringRequiredformat: "uuid"

The customer who performed the action.

event_namestringRequired

The name or ID of the usage event definition. Must match an active event in your account.

subscription_idstring or nullOptionalformat: "uuid"

Optional subscription to associate the event with.

timestampdatetime or nullOptional

When the event occurred. Defaults to the current time.

propertiesmap from strings to any or nullOptional

Custom key-value properties for the event.

idempotency_keystring or nullOptional

Unique key to prevent duplicate event processing.

Response

Usage event reported successfully

dataobject

Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

500

Internal Server Error