---
title: "Get a bill"
method: GET
path: "/v1/bills/{id}"
tags: ["Bill"]
---

# Get a bill

`GET /v1/bills/{id}`

Returns a single bill by id, including its `charges_with_descriptions` breakdown.

Company users may only read bills for companies they belong to; requesting a bill
outside that scope returns `404 Not Found`.

## Path parameters

- `id` string, uuid, required

## Parameters

- `#/paths/~1v1~1bills/get/parameters/0` — unresolved $ref

## Response `200`

The requested bill.

- Bill — A monthly billing document for a company, aggregating Cardda's commission charges (and commission refunds) for a period. Amounts are in the smallest currency unit (CLP has no decimals, so cents == pesos).
  - `id` string, uuid, required
  - `company_id` string, uuid, required — Company the bill belongs to.
  - `month` integer, nullable
  - `year` integer, nullable
  - `status` string, nullable — Lifecycle state of the bill. - `draft` - being assembled, not yet issued - `preissued` - pre-issued at the tax authority - `issued` - final tax document emitted
  - `transition` string, nullable — In-flight state transition, when a status change is being processed.
  - `external_id` string, nullable — Identifier of the emitted document at the external billing provider.
  - `total_amount` integer, nullable — Total amount of the bill, in the smallest currency unit.
  - `date` string, date, nullable — Issue date of the bill.
  - `fiscal_invoice_id` string, nullable — Identifier of the associated fiscal (SII) invoice, when emitted.
  - `charges` object, nullable — Raw per-product charge map (`{ "<product>": <amount_cents> }`) accumulated from the underlying commissions.
  - `charges_with_descriptions` object[] — Human-readable breakdown of `charges`, added via the `charges_with_descriptions` serializer method. Each entry pairs an amount with a localized product description.
    - `amount` integer
    - `description` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Unauthorized - missing or invalid authentication token.
- `404` — Bill not found (or outside the caller's company scope).

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) · [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cardda/banking-api/revisions/ff1aeb3fda8b/schema)