Understand billing and usage

EntireFeed uses prepaid usage billing. Estimation is free. Creating a paid generation reserves its current estimate from available balance while work is active.

Read balance without changing it

GET /v1/billing/summary returns available, reserved, and total USD amounts. GET /v1/billing/ledger returns immutable balance movements and supports cursor, type, date, and generation filters.

Public API keys can only read billing data. Adding balance and managing payment methods remain signed-in Console actions.

Reconcile each generation

Read usage.billing_status on the generation. reserved means the estimate is still held. settled means usage was charged. released means held balance returned to available balance. manual_review means automation must stop until the cost is resolved.

The ledger is the audit trail. A single generation can produce a reserve followed by settlement, release, or a bounded adjustment. When final cost exceeds the reservation, any extra debit is capped at the current available balance and cannot make that balance negative.

curl https://api.entirefeed.com/v1/billing/summary \
  -X GET \
  -H "Authorization: Bearer $ENTIREFEED_API_KEY"

{
  "available": {
    "amount_usd": "23.80"
  },
  "reserved": {
    "amount_usd": "1.20"
  },
  "total": {
    "amount_usd": "25.00"
  },
  "currency": "usd"
}

curl https://api.entirefeed.com/v1/billing/ledger?generation_id=gen_0123456789abcdef0123456789abcdef \
  -X GET \
  -H "Authorization: Bearer $ENTIREFEED_API_KEY"

{
  "data": [
    {
      "id": "8e2dc660-4b75-4a51-9176-6d70fe0b2c08",
      "type": "RESERVE",
      "amount_usd": "-1.20",
      "available_after_usd": "23.80",
      "reserved_after_usd": "1.20",
      "generation_id": "gen_0123456789abcdef0123456789abcdef",
      "description": "Reserved estimated operation cost.",
      "created_at": "2026-07-12T08:30:00Z"
    }
  ],
  "next_cursor": null
}