---
title: "Usage Report"
method: GET
path: "/api/v1/usage"
tags: ["usage"]
---

# Usage Report

`GET /api/v1/usage`

## Request

- Base URL: `https://api.maritime.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maritime.sh/api/v1/usage`
- Auth: HTTP bearer

## Query parameters

- `from` string, nullable: ISO start (default: to - 30d)
- `to` string, nullable: ISO end (default: now)
- `projectId` string, nullable
- `externalUserId` string, nullable

## Response `200`

Successful Response

- UsageReport
  - `periodStart` string, date-time, required
  - `periodEnd` string, date-time, required
  - `hostingBasis` string
  - `plan` string, nullable
  - `computeMinutes` number, required
  - `hostingCostCents` integer, required
  - `llmCostCents` number, required
  - `totalCostCents` number, required
  - `agents` AgentUsage[], required
    - `agentId` string, required
    - `source` string
    - `agentName` string, nullable
    - `externalUserId` string, nullable
    - `projectId` string, nullable
    - `computeMinutes` number, required
    - `hostingCostCents` integer, required
    - `slotCostCents` integer
    - `addOnCostCents` integer
    - `llmCostCents` number, required
    - `totalCostCents` number, required

## Other responses

- `422`: Validation Error

---

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