---
title: "Add Usage"
method: POST
path: "/api/subscriptions/{subscription_id}/usage"
tags: ["Subscriptions"]
---

# Add Usage

`POST /api/subscriptions/{subscription_id}/usage`

## Request

- Base URL: `https://api.typless.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.typless.com/api/subscriptions/{subscription_id}/usage`
- Auth: none declared

Can only be used to add SUPPORT_MINUTES!

## Path parameters

- `subscription_id` string, uuid, required

## Request body

- AddUsageRequest
  - `quantity` integer, required
  - `notes` string, nullable
  - `issue_link` string, nullable
  - `usage_date` string, date, nullable

## Response `200`

Successful Response

- UsageDTO
  - `id` string, uuid, required
  - `subscription_id` string, uuid, required
  - `type` 'PAGES' | 'SUPPORT_MINUTES' | 'ADDITIONAL_FIELD_EXTRACTIONS' | 'LINE_ITEM_PAGES', required
  - `created_at` string, date-time, required
  - `business_unit_id` string, uuid, nullable, required
  - `quantity` integer, required
  - `notes` string, nullable
  - `usage_date` string, date, nullable
  - `issue_link` string, nullable

## Other responses

- `422`: Validation Error

---

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