---
title: "Retrieve a bill"
method: GET
path: "/subscriptions/{subscription_id}/bills/{bill_id}"
tags: ["Subscription Bills"]
---

# Retrieve a bill

`GET /subscriptions/{subscription_id}/bills/{bill_id}`

Returns the bill using the unique `bill_id`.

## Path parameters

- `subscription_id` string, required
- `bill_id` string, required

## Response `200`

Bill details.

- Bill
  - `id` string, required — Unique ID assigned by Acquired to the bill when it is created.
  - `subscription_id` string, required — ID of the subscription this bill belongs to.
  - `customer` object, required — The customer associated with this bill.
    - `customer_id` string, uuid, required — Unique ID assigned by Acquired to the customer.
  - `status` 'draft' | 'open' | 'paid' | 'void' | 'past_due' | 'unpaid', required — Current lifecycle status of the bill.
  - `amount` object, required — Breakdown of the bill amount in major currency units. Reflects any active subscription discount.
    - `base` number, required — The pre-discount amount for this billing cycle.
    - `discount` number, required — The discount amount applied to this bill.
    - `total` number, required — The final amount due after discount (`base` minus `discount`).
    - `status` 'finalised' | 'projected', required — Whether the amount was finalised at bill close (`finalised`) or is still a forward-looking projection (`projected`).
  - `currency` string, required — The currency the bill is denominated in.
  - `due_date` string, date-time, required — When this bill is due to be paid.
  - `transactions` object[], required — List of transactions associated with this bill.
    - `transaction_id` string, uuid, required — Unique ID of the payment attempt against this bill.
    - `status` string, required — Outcome status of the payment attempt.
    - `type` string, required — The kind of transaction recorded against the bill, e.g. `payment`.
    - `payment_method` string, required — The payment method used for the attempt, e.g. `card`.
  - `created_at` string, date-time, required — When the bill record was created.
  - `links` object[], required
    - `rel` 'self'
    - `href` string — Link to the resource which should be appended to base URL.
    - `method` string — The HTTP method to use with the link.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

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