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

# POST /v1/usage-invoices

`POST /v1/usage-invoices`

## Request

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

## Request body

- UsageInvoiceDraftV1
  - `clientRef` string, uuid, required
  - `concept` string
  - `currency` string
  - `emisorId` string
  - `externalRef` string
  - `lines` UsageLineV1[]
    - `description` string, required
    - `quantity` number, double, required
    - `unitPriceCents` integer, required
  - `periodFrom` string, date
  - `periodTo` string, date

## Response `200`

OK

- UsageInvoiceV1
  - `clientRef` string, uuid
  - `concept` string
  - `confirmationUrl` string
  - `currency` string
  - `error` string
  - `invoiceId` string, uuid
  - `message` string
  - `operationId` string, uuid
  - `paid` boolean
  - `paymentUrl` string
  - `periodFrom` string, date
  - `periodTo` string, date
  - `planId` string, uuid
  - `reason` string
  - `status` string
  - `subtotalMinor` integer
  - `taxJurisdiction` string
  - `taxKind` string
  - `taxMinor` integer
  - `taxRate` number, double
  - `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)