---
title: "Remove um período de utilização através do ID."
method: DELETE
path: "/v1/usages/{id}"
tags: ["usages"]
---

# Remove um período de utilização através do ID.

`DELETE /v1/usages/{id}`

Somente é possível remover um registro de utilização que não está associado a uma fatura. Se o período já estiver faturado, será necessário cancelar a fatura antes de removê-lo.

## Path parameters

- `id` integer, required

## Response `200`

Registro de utilização removido com sucesso.

- Usage — Para criar um novo registro de utilização em um período é necessário informar um dos produtos contidos na assinatura. Isso pode ser feito através do atributo `product_id` (ID do produto) ou `product_item_id` (ID do item da assinatura). Ao remover um registro com sucesso, o próprio será retornado no corpo da resposta.
  - `id` integer, required — ID do registro de utilização
  - `description` string — Descrição opcional
  - `created_at` string, required — Data e hora da geração do registro de utilização
  - `metadata` object — Metadados do registro de utilização
  - `product_item` ProductItemSummary, required
    - `id` integer, required — ID do item
    - `product` ProductSummary, required
      - `id` integer, required — ID do produto
      - `name` string, required — Nome do produto
      - `code` string — Código externo do produto
  - `bill` BillSummary
    - `id` integer, required — ID da fatura
    - `code` string — Código externo para referência via API
  - `quantity` integer, required — Quantidade informada no registro de utilização

## Other responses

- `400` — Erro de sintaxe JSON no corpo do request.
- `404` — Registro de utilização não encontrado.
- `422` — Parâmetros inválidos. Verificar erro na resposta.

---

[API](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost.md) · [All operations](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vindi/001-vindi-pagamentos-agost/revisions/9d11e5de9308/schema)