# Invoice items

> One-off charges or credits queued for a customer's next subscription invoice.

Source: https://docs.borga.is/api/invoice-items

**The invoice item object**

- `id` (string): Prefixed `ii_`.
- `object` (string): `invoice_item`
- `customer` (string): - `subscription` (string | null) <Param name="invoice" type="string | null">Set once the item has been placed on an invoice.
- `amount` (integer): Per unit. Negative for credits.
- `currency` (string): <Param name="description" type="string">Shown as the invoice line.
- `quantity` (integer): - `metadata` (object) - `created_at` (timestamp) ## Create an invoice item `POST /v1/invoice_items` **Body** - `customer` (string) <Param name="amount" type="integer" required>Per unit in the smallest currency unit. Negative amounts create credits.
- `description` (string, required): <Param name="subscription" type="string">Place the item on this subscription's next invoice. Must belong to `customer`.
- `currency` (string, default ISK): Must match the subscription's currency when one is given.
- `quantity` (integer, default 1): - `metadata` (object) ```bash curl https://api.borga.is/v1/invoice_items \ -H "Authorization: Bearer sk_test_…" \ -H "Content-Type: application/json" \ -d '{ "customer": "cus_8Jk2Lm4Np6Qr8St0Uv2Wx4Yz", "subscription": "sub_9Qw1Er3Ty5Ui7Op9As1Df3Gh", "amount": 15000, "description": "Onboarding workshop" }' ``` Errors: [`mismatch`](/errors/mismatch), [`currency_mismatch`](/errors/currency_mismatch), [`resource_not_found`](/errors/resource_not_found). ## Retrieve an invoice item `GET /v1/invoice_items/:id` ## List invoice items `GET /v1/invoice_items` **Query parameters** - `customer` (string) - `subscription` (string) <Param name="pending" type="boolean">`true` returns only items not yet invoiced.
- `limit` (integer)
- `starting_after` (string)