---
title: "Summarize paid invocations owned by the authenticated vendor"
method: POST
path: "/v1/paid-invocations/overview"
tags: ["billing", "paid-invocations"]
---

# Summarize paid invocations owned by the authenticated vendor

`POST /v1/paid-invocations/overview`

## Request

- Base URL: `https://api.runx.ai`
- URL: `https://api.runx.ai/v1/paid-invocations/overview`
- Auth: HTTP bearer

## Response `200`

Typed paid-invocation result.

- PaidInvocationVendorOverviewContract
  - `schema` 'runx.paid_invocation_vendor_overview.v1', required
  - `generated_at` string, date-time, required
  - `periods` object[], required
    - `period` 'last_24_hours' | 'last_7_days' | 'last_30_days' | 'all_time', required
    - `metrics` PaidInvocationVendorMetricsContract, required
      - `invocation_count` integer, required
      - `paid_call_count` integer, required
      - `successful_call_count` integer, required
      - `failed_call_count` integer, required
      - `in_progress_call_count` integer, required
      - `delivered_call_count` integer, required
      - `refunded_call_count` integer, required
      - `unique_payer_count` integer, required
      - `repeat_payer_count` integer, required
      - `money` object[], required
        - `currency` Currency, required (unresolved $ref)
        - `gross_amount_minor` integer, required
        - `refunded_amount_minor` integer, required
  - `tools` object[], required
    - `offer_id` string, required
    - `metrics` PaidInvocationVendorMetricsContract, required
      - `invocation_count` integer, required
      - `paid_call_count` integer, required
      - `successful_call_count` integer, required
      - `failed_call_count` integer, required
      - `in_progress_call_count` integer, required
      - `delivered_call_count` integer, required
      - `refunded_call_count` integer, required
      - `unique_payer_count` integer, required
      - `repeat_payer_count` integer, required
      - `money` object[], required
        - `currency` Currency, required (unresolved $ref)
        - `gross_amount_minor` integer, required
        - `refunded_amount_minor` integer, required
    - `last_paid_at` string, date-time
  - `tools_truncated` boolean, required
  - `daily` object[], required
    - `date` string, date, required
    - `metrics` PaidInvocationVendorMetricsContract, required
      - `invocation_count` integer, required
      - `paid_call_count` integer, required
      - `successful_call_count` integer, required
      - `failed_call_count` integer, required
      - `in_progress_call_count` integer, required
      - `delivered_call_count` integer, required
      - `refunded_call_count` integer, required
      - `unique_payer_count` integer, required
      - `repeat_payer_count` integer, required
      - `money` object[], required
        - `currency` Currency, required (unresolved $ref)
        - `gross_amount_minor` integer, required
        - `refunded_amount_minor` integer, required

## Other responses

- `400`: Invalid current-V1 request envelope.
- `401`: Unauthorized.
- `403`: Missing scope or owner mismatch.
- `429`: Paid-invocation request rate limited.
- `503`: Paid-invocation service unavailable.

---

[API](https://skmtc.dev/runx/apis/runx-hosted-api.md) · [All operations](https://skmtc.dev/runx/apis/runx-hosted-api/llms.txt) · [OpenAPI document](https://skmtc.dev/runx/apis/runx-hosted-api/revisions/6c940d8edacc?raw)