---
title: "List recent metered calls"
method: GET
path: "/api/v1/wallet/invocations"
---

# List recent metered calls

`GET /api/v1/wallet/invocations`

## Request

- Base URL: `https://prowl.chat`
- URL: `https://prowl.chat/api/v1/wallet/invocations`
- Auth: HTTP bearer

Every tool call this account has been billed for, newest first, with what the provider charged and what the wallet was debited. Use it to reconcile a balance against the work that produced it.

## Query parameters

- `limit` integer

## Headers

- `authorization` string, nullable

## Cookies

- `prowl_session` string, nullable

## Response `200`

Successful Response

- InvocationsResponse: Recent metered calls, newest first.
  - `invocations` ToolInvocation[], required
    - `tool_name` string, required: Registry name of the tool that was called.
    - `provider_cost_usd` number, required: What the upstream provider charged for this call.
    - `billed_usd` number, required: What this call actually debited from the wallet.
    - `markup_usd` number, required: The difference between the two figures above.
    - `success` boolean, required: Whether the provider returned a usable result.
    - `latency_ms` integer, nullable: Round-trip time in milliseconds.
    - `api_key_id` string, nullable: Which API key made the call.
    - `created_at` string, nullable: ISO-8601 timestamp of the call.
  - `count` integer, required: Number of rows in this response, not the lifetime total.

## Other responses

- `401`: Missing, malformed or expired credential.
- `422`: Validation Error

---

[API](https://skmtc.dev/prowl/apis/prowl-rest-api-v1.md) · [All operations](https://skmtc.dev/prowl/apis/prowl-rest-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/prowl/apis/prowl-rest-api-v1/revisions/897e8b30c330?raw)