---
title: "Retorna um item específico através do ID."
method: GET
path: "/v1/bill_items/{id}"
tags: ["bill_items"]
---

# Retorna um item específico através do ID.

`GET /v1/bill_items/{id}`

## Request

- Base URL: `//app.vindi.com.br/api` (relative, and the document’s source URL is not known)
- URL: `//app.vindi.com.br/api/v1/bill_items/{id}`
- Auth: HTTP basic

Além das informações básicas sobre o item da fatura, através deste método é possível obter todos os registros de utilização associados ao item.

## Path parameters

- `id` integer, required

## Response `200`

Ok. Item da fatura encontrado.

- BillItemIncludingUsages: Além das informações básicas sobre o item da fatura, através deste método é possível obter todos os registros de utilização associados ao item.
  - `id` integer, required: ID do item da fatura
  - `amount` number, required: Valor do item da fatura
  - `quantity` integer: Quantidade do item da fatura
  - `pricing_range_id` integer: ID da faixa de precificação usada no cálculo do preço, se aplicável
  - `description` string: Descrição opcional do item da fatura
  - `pricing_schema` PricingSchema
    - `id` string, required: ID do esquema de precificação
    - `short_format` string, required: Descrição da precificação gerada automaticamente
    - `price` number, required: Preço base
    - `minimum_price` number: Preço mínimo
    - `schema_type` 'flat' | 'per_unit' | 'step_usage' | 'volume_usage' | 'tier_usage', required: Tipo de cálculo da precificação
    - `pricing_ranges` PricingRange[]: Lista de faixas de precificação
      - `id` string, required: ID do faixa de precificação
      - `start_quantity` integer, required: Início da faixa
      - `end_quantity` integer: Término da faixa. Opcional apenas para a última
      - `price` number, required: Preço da unidade ou da faixa, dependendo do tipo escolhido
      - `overage_price` number: Preço unitário do excedente da faixa
    - `created_at` string, required: Data e hora do cadastro do esquema de precificação
  - `product` ProductSummary, required
    - `id` integer, required: ID do produto
    - `name` string, required: Nome do produto
    - `code` string: Código externo do produto
  - `product_item` ProductItemSummary
    - `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
  - `discount` DiscountSummary
    - `id` integer, required: ID do desconto
    - `discount_type` 'percentage' | 'amount' | 'quantity', required: Tipo do desconto
    - `percentage` number: Valor numérico para porcentagem de 0.01 até 100
    - `amount` number: Valor para desconto fixo
    - `quantity` integer: Número para desconto por quantidade
    - `cycles` integer: Número de ciclos de recorrência onde o desconto será aplicado a partir do momento de sua criação. Nulo significa desconto por tempo indefinido
  - `usages` UsageSummary[]: Registros de utilização associados ao item da fatura
    - `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
    - `quantity` integer, required: Quantidade do registro de utilização
    - `base_amount` integer, required: Valor base informado no registro de utilização

## Other responses

- `400`: Erro de sintaxe JSON no corpo do request.
- `404`: Item da fatura não encontrado.
- `422`: Parâmetros inválidos. Verificar erro na resposta.

---

[API](https://skmtc.dev/vindi/apis/api-vindi.md) - [All operations](https://skmtc.dev/vindi/apis/api-vindi/llms.txt) - [OpenAPI document](https://skmtc.dev/vindi/apis/api-vindi/revisions/3e857e1cdd03?raw)