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

# POST /v1/usage-plans

`POST /v1/usage-plans`

## Request

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

## Request body

- UsagePlanDraftV1
  - `autoCharge` boolean
  - `autoIssue` boolean
  - `clientRef` string, uuid, required
  - `concept` string
  - `currency` string
  - `emisorId` string
  - `externalRef` string
  - `periodCapCents` integer
  - `seriesId` string, uuid
  - `taxRate` number, double

## Response `200`

OK

- UsagePlanApprovalV1
  - `approval` PendingApproval
    - `approvalUrl` string
    - `createdAt` string, date-time
    - `expiresAt` string, date-time
    - `message` string
    - `operation` string
    - `operationId` string, uuid
    - `requiresDeviceVerification` boolean
    - `status` string
    - `summary` string
    - `title` string
  - `plan` UsagePlanV1
    - `authorizedAt` string, date-time
    - `autoCharge` boolean
    - `autoIssue` boolean
    - `clientRef` string, uuid
    - `concept` string
    - `createdAt` string, date-time
    - `currency` string
    - `externalRef` string
    - `id` string, uuid
    - `paymentMethodStored` boolean
    - `periodCapCents` integer
    - `status` string
    - `taxRate` number, double

---

[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)