---
title: "Invoice history and spend summary"
method: GET
path: "/invoices"
tags: ["Account"]
---

# Invoice history and spend summary

`GET /invoices`

## Request

- Base URL: `https://riskmodels.app/api`
- URL: `https://riskmodels.app/api/invoices`
- Auth: HTTP bearer

Returns paginated invoice history and a summary of spend by period (month/quarter/year).

## Query parameters

- `limit` integer
- `period` 'month' | 'quarter' | 'year'

## Response `200`

Invoice list and spend summary.

- object
  - `invoices` object[]
    - `status` string
    - `amount_usd` number, float
  - `summary` object
    - `period` string
    - `total_invoices` integer
    - `total_spent_usd` number, float
    - `total_requests` integer
    - `current_period_cost_usd` number, float

## Other responses

- `401`: Missing or invalid Bearer token.
- `402`: Insufficient balance.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/riskmodels/apis/riskmodels-api.md) · [All operations](https://skmtc.dev/riskmodels/apis/riskmodels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/riskmodels/apis/riskmodels-api/revisions/1a034cad408a?raw)