Consumption Events - List - Laburen Documentacion

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
  }
}

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.

Hide Consumption event object

string

Unique identifier of the consumption event.

organizationId

string

ID of the organization that owns this event.

agentId

string

ID of the agent that generated this event.

feature

string

The feature that triggered the consumption (e.g. chat, transcription).

provider

string

The AI provider used (e.g. openai, anthropic).

modelName

string

The model name used (e.g. gpt-4, claude-3-opus).

inputTokens

integer

Number of input tokens consumed.

outputTokens

integer

Number of output tokens generated.

units

number

Number of units consumed (for non-token-based features).

creditsCharged

number

Final credits charged after applying the billing coefficient.

creditsChargedRaw

number

Raw credits before billing coefficient adjustment.

billingCoefficient

number

Multiplier applied to raw credits to calculate the final charge.

occurredAt

string (ISO 8601)

Timestamp when the consumption event occurred.

metadata

object

Additional metadata associated with the event.

conversationId

string

ID of the conversation that generated this event (if applicable).

messageId

string

ID of the message that generated this event (if applicable).

agent

object

Agent summary.

Show Agent object

string

Agent ID.

name

string

Agent name.

pagination

object

Pagination metadata.

Hide Pagination object

Error Responses

Status Code	Type	Description
400	INVALID_REQUEST	`startDate` is after `endDate`
401	UNAUTHORIZED	Missing 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
  }
}

Annotation Tags - Delete Consumption Events - Summary

​Query Parameters

​Optional

​Response

​Error Responses

Query Parameters

Optional

Response

Error Responses