List receipts

GET/v1/login/boo-admin/receipts

Each Boo request in a billing period: who made it, in which account, its state, what was reserved for it and what it was charged. Until your organization has its first billing period, this answers 404 with not_found.

Permission: boo-admin:GetUsage

Query parameters

Name
period_id a billing period; the current one if left out
account_id only this account's receipts
person_id only this person's receipts
page_size receipts per page, 1 to 100 (50 if left out)
after the next_after of the page before

Returns

200 OK

{
  "period": {
    "id": "5d2e8c71-9a4b-4e3f-8c1d-2b6a7f0e9d34",
    "starts_at": "2026-11-01T00:00:00Z",
    "ends_at": "2026-12-01T00:00:00Z"
  },
  "receipts": [
    {
      "operation_id": "c41f0a6e-2d8b-4b17-9e35-6a0f8d2c7b91",
      "person_id": "8f0c2c1e-6b1a-4f3e-9a51-0c3d2f7e9b10",
      "account_id": "100000000123",
      "environment_id": "e2a91d4c-7b3f-4c60-8e15-9d0b6f3a2c48",
      "state": "settled",
      "reserved_micros": "3000000",
      "actual_micros": "2400000",
      "pricing_ref": "org-inference/standard/model-id",
      "created_at": "2026-11-20T09:58:00Z"
    }
  ],
  "next_after": "",
  "as_of": "2026-11-20T10:12:00Z"
}

pricing_ref names what was charged for: org-inference/<tariff>/<model> for a model, org-resources/<tariff> for compute. Amounts are micros, millionths of a credit, as strings: "25000000" is 25 credits.

Example

curl "https://<company>.yotta.bot/v1/login/boo-admin/receipts?person_id=8f0c2c1e-6b1a-4f3e-9a51-0c3d2f7e9b10" \
  -H "Authorization: Bearer $YOTTABOT_TOKEN"

With yottactl

yottactl org boo receipts --query person_id=8f0c2c1e-6b1a-4f3e-9a51-0c3d2f7e9b10