Skip to main content
GET
/
tokens
/
history
Get token usage history
curl --request GET \
  --url https://api-service.fribl.co/api/v1/tokens/history \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "id": "10472",
      "workspace_id": "ws_a1b2c3d4",
      "action": "cv_processing",
      "amount": -1,
      "balance_after": "151",
      "created_at": "2026-06-03T10:15:30.000Z",
      "reference_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "metadata": {}
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

API key in UUID format. Include this header with every authenticated request.

Query Parameters

​
limit
integer
default:50

Maximum number of ledger entries to return.

Required range: 1 <= x <= 500
​
before
string<date-time>

Return only entries created strictly before this ISO 8601 timestamp. Use for backward pagination.

Response

Ledger entries, newest first.

​
data
object[]
required