---
title: "POST /v1/usage-records"
method: POST
path: "/v1/usage-records"
tags: ["usage-records-v-1-controller"]
---

# POST /v1/usage-records

`POST /v1/usage-records`

## Request

- Base URL: `https://api.xestando.com`
- URL: `https://api.xestando.com/v1/usage-records`
- Auth: HTTP bearer

## Request body

- UsageRecordDraftV1
  - `events` Event[], required
    - `description` string, required
    - `externalId` string, required
    - `occurredAt` string, date-time
    - `quantity` number, double, required
    - `unitPriceCents` integer, required
  - `planId` string, uuid, required

## Response `200`

OK

- UsageSummary
  - `currency` string
  - `feeMinor` integer
  - `lines` UsageInvoiceLineCommand[]
    - `description` string
    - `quantity` number, double
    - `unitPriceCents` integer
  - `netMinor` integer
  - `planId` string, uuid
  - `records` integer
  - `subtotalMinor` integer
  - `taxMinor` integer
  - `totalMinor` integer

---

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