---
title: Subscription Usage
description: The data, voice and SMS usage of a subscription.

---

# Subscription Usage

The data, voice and SMS usage of a subscription.


## [GET /subscriptions/{subscriptionId}/usage](/end-user-api/subscription-usage#tag/subscription-usage/GET/subscriptions/{subscriptionId}/usage)

Get subscription usage

Retrieve the current period's usage for a subscription.

Authentication: X-Api-Key + Bearer JWT

### Path parameters

- `subscriptionId` (`string`, required) — The identifier of the subscription. May be the entity's internal UUID or an external reference identifier. Reference identifiers MUST be prefixed with `rid_` (e.g., `rid_crm-subscription-12345`) so the API can distinguish them from internal UUIDs. The prefix is stripped before lookup.

### Responses

#### 200

Current usage statistics for the subscription.

Type: [Usage](/end-user-api/models.md#models/Usage)

#### 400

The request was malformed or invalid.

Type: [Error](/end-user-api/models.md#models/Error)

#### 401

Authentication is required to access this resource.

Type: [Error](/end-user-api/models.md#models/Error)

#### 403

Access to this resource is forbidden.

Type: [Error](/end-user-api/models.md#models/Error)

#### 404

The requested resource was not found.

Type: [Error](/end-user-api/models.md#models/Error)

#### 500

An unexpected error occurred on the server.

Type: [Error](/end-user-api/models.md#models/Error)

### Example request

```bash
curl https://apiv2.example.com/api/v2/end-user/subscriptions/SUBSCRIPTION_ID/usage \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```