Skip to main content
GET
/
api
/
consumption-events
curl --location --request GET 'https://dashboard.laburen.com/api/consumption-events?startDate=2025-01-01T00:00:00.000Z&endDate=2025-01-31T23:59:59.000Z&page=1&limit=20&orderBy=occurredAt_desc' \
--header 'Authorization: Bearer <API_KEY>'

{
  "data": [
    {
      "id": "clxxxxxxxxxxxxxxxxx",
      "organizationId": "clxxxxxxxxxxxxxxxxx",
      "agentId": "clxxxxxxxxxxxxxxxxx",
      "feature": "chat",
      "provider": "openai",
      "modelName": "gpt-4",
      "inputTokens": 1250,
      "outputTokens": 430,
      "units": null,
      "creditsCharged": 0.0285,
      "creditsChargedRaw": 0.0285,
      "billingCoefficient": 1.0,
      "occurredAt": "2025-01-15T14:32:10.000Z",
      "metadata": {},
      "conversationId": "clxxxxxxxxxxxxxxxxx",
      "messageId": "clxxxxxxxxxxxxxxxxx",
      "agent": {
        "id": "clxxxxxxxxxxxxxxxxx",
        "name": "Support Bot"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 154,
    "totalPages": 8
  }
}
Este endpoint requiere autenticacion. Inclui tu API key en el header Authorization: Bearer <API_KEY>. Ver Autenticacion para mas detalles.
Returns a paginated list of consumption events for the authenticated organization. Use this endpoint to:
  • Browse individual consumption events with full detail
  • Filter by date range, agent, feature, provider, model, or conversation
  • Sort by date or credits charged
  • Paginate through large result sets

​
Query Parameters

​
Optional

​
startDate
string (ISO 8601)
Filter events that occurred on or after this date. Must be a valid ISO 8601 datetime string (e.g. 2025-01-01T00:00:00.000Z).
​
endDate
string (ISO 8601)
Filter events that occurred on or before this date. Must be a valid ISO 8601 datetime string. Must be greater than or equal to startDate if both are provided.
​
agentId
string
Filter events by a specific agent ID.
​
feature
string
Filter events by feature name (e.g. chat, transcription).
​
provider
string
Filter events by AI provider (e.g. openai, anthropic).
​
modelName
string
Filter events by model name (e.g. gpt-4, claude-3-opus).
​
conversationId
string
Filter events by conversation ID.
​
page
integer
default:"1"
Page number for pagination. Minimum value: 1.
​
limit
integer
default:"50"
Number of events per page. Minimum: 1, maximum: 100.
​
orderBy
string
default:"occurredAt_desc"
Sort order for results. Valid values: occurredAt_asc, occurredAt_desc, creditsCharged_asc, creditsCharged_desc.

​
Response

​
data
array
List of consumption events.
​
pagination
object
Pagination metadata.

​
Error Responses

Status CodeTypeDescription
400INVALID_REQUESTstartDate is after endDate
401UNAUTHORIZEDMissing or invalid authentication
curl --location --request GET 'https://dashboard.laburen.com/api/consumption-events?startDate=2025-01-01T00:00:00.000Z&endDate=2025-01-31T23:59:59.000Z&page=1&limit=20&orderBy=occurredAt_desc' \
--header 'Authorization: Bearer <API_KEY>'

{
  "data": [
    {
      "id": "clxxxxxxxxxxxxxxxxx",
      "organizationId": "clxxxxxxxxxxxxxxxxx",
      "agentId": "clxxxxxxxxxxxxxxxxx",
      "feature": "chat",
      "provider": "openai",
      "modelName": "gpt-4",
      "inputTokens": 1250,
      "outputTokens": 430,
      "units": null,
      "creditsCharged": 0.0285,
      "creditsChargedRaw": 0.0285,
      "billingCoefficient": 1.0,
      "occurredAt": "2025-01-15T14:32:10.000Z",
      "metadata": {},
      "conversationId": "clxxxxxxxxxxxxxxxxx",
      "messageId": "clxxxxxxxxxxxxxxxxx",
      "agent": {
        "id": "clxxxxxxxxxxxxxxxxx",
        "name": "Support Bot"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 154,
    "totalPages": 8
  }
}