---
title: "The caller's runner spend for a month"
method: GET
path: "/api/v1/me/billing/spend"
tags: ["Me"]
---

# The caller's runner spend for a month

`GET /api/v1/me/billing/spend`

## Request

- Base URL: `https://entire.io` (the document declares no server; this is the origin it was published from)
- URL: `https://entire.io/api/v1/me/billing/spend`
- Auth: none declared

## Query parameters

- `period` string

## Response `200`

Gross runner spend for the month, nested by project, repo and runner. Amounts for a month that is not final can still change.

- object
  - `period` string, required
  - `final` boolean, required
  - `currency` string, required
  - `total_cents` integer, required
  - `available_periods` object, required
    - `earliest` string, required
    - `latest` string, required
  - `projects` object[], required
    - `id` string, required
    - `name` string
    - `deleted` boolean, required
    - `total_cents` integer, required
    - `repos` object[], required
      - `id` string, required
      - `name` string
      - `deleted` boolean, required
      - `total_cents` integer, required
      - `runners` object[], required
        - `key` string, required
        - `kind` string, required
        - `total_cents` integer, required
  - `other_usage` object[], required
    - `name` string, required
    - `amount_cents` integer, required

## Other responses

- `400`: Invalid request
- `401`: Not authenticated
- `403`: Access denied
- `404`: Resource not found
- `409`: Resource conflict
- `412`: Precondition failed
- `422`: Validation failed
- `429`: Too many requests
- `502`: Entire Core request failed
- `503`: Entire Core is unavailable. Type "billing-not-configured" means billing is not configured.

## Changes

- **2026-10-18** `243979668103`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/me/billing/spend/get.md)

---

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