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

# Get Usage

`GET /v1/usage`

Get usage statistics for the current account.

Returns:
- Phone number limits (used/limit/remaining)
- Message statistics (total, last 24h, last 7 days, last 30 days)
- Call statistics (total, last 24h, last 7 days, last 30 days)
- Webhook delivery statistics

## Response `200`

Successful Response

- UsageResponse
  - `plan` PlanInfo, required
    - `name` string, required
    - `limits` PlanLimits, required
      - `numbers` integer, required
      - `messagesPerMonth` integer, required
      - `voiceMinutesPerMonth` integer, required
      - `maxCallDurationMinutes` integer, required
      - `concurrentCalls` integer, required
  - `numbers` NumberLimits, required
    - `used` integer, required
    - `limit` integer, required
    - `remaining` integer, required
  - `stats` UsageStats, required
    - `totalMessages` integer, required
    - `messagesLast24h` integer, required
    - `messagesLast7d` integer, required
    - `messagesLast30d` integer, required
    - `totalCalls` integer, required
    - `callsLast24h` integer, required
    - `callsLast7d` integer, required
    - `callsLast30d` integer, required
    - `totalWebhookDeliveries` integer, required
    - `successfulWebhookDeliveries` integer, required
    - `failedWebhookDeliveries` integer, required
  - `periodStart` string, required
  - `periodEnd` string, required

---

[API](https://skmtc.net/agentphone/apis/agentphone-api.md) · [All operations](https://skmtc.net/agentphone/apis/agentphone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agentphone/agentphone-api/revisions/1f6f2b124adf/schema)