---
title: "Record usage"
method: POST
path: "/usages/"
tags: ["Billing"]
---

# Record usage

`POST /usages/`

## Headers

- `x-simple-workspace` string, required
- `x-piriod-test-mode` boolean

## Request body

- Usage — A usage record posted against a metered subscription line. The line's plan must have `usage_scheme=metered`.
  - `id` integer
  - `subscription_line` integer, required — Subscription line ID this usage belongs to.
  - `date_time` string, date-time, required — Timestamp the usage was recorded for.
  - `quantity` number, required
  - `creation_scheme` 'api' | 'file' | 'panel'
  - `created` string, date-time

## Response `201`

Usage recorded.

- Usage — A usage record posted against a metered subscription line. The line's plan must have `usage_scheme=metered`.
  - `id` integer
  - `subscription_line` integer, required — Subscription line ID this usage belongs to.
  - `date_time` string, date-time, required — Timestamp the usage was recorded for.
  - `quantity` number, required
  - `creation_scheme` 'api' | 'file' | 'panel'
  - `created` string, date-time

## Other responses

- `400` — Request body or query parameters failed validation.

---

[API](https://skmtc.net/piriod/apis/piriod-api.md) · [All operations](https://skmtc.net/piriod/apis/piriod-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/piriod/piriod-api/versions/70cbc827dc7b/schema)