Invoice Items API

Invoice Items are individual line items that appear on an invoice. You add them to a draft invoice before finalizing.

Create an Invoice Item

POST /v1/invoiceItems

Parameter	Type	Description
customer required	string	Customer to bill.
amount required	integer	Amount in cents.
currency required	string	Three-letter ISO currency code.
invoice	string	Draft invoice ID to attach this item to.
description	string	Line item description shown on the invoice.
quantity	integer	Quantity (amount is per unit). Default: 1.

curl https://api.meridian.dev/v1/invoiceItems \
  -u sk_test_4eC39HqL...: \
  -d customer=cus_Nk3mHXq7ViGwMz \
  -d invoice=in_InvoiceId \
  -d amount=5000 \
  -d currency=usd \
  -d description="Add-on: Analytics dashboard"

Retrieve an Invoice Item

GET /v1/invoiceItems/:id

Update an Invoice Item

POST /v1/invoiceItems/:id

Update amount, description, or quantity while the invoice is still in draft.

Delete an Invoice Item

DELETE /v1/invoiceItems/:id

curl -X DELETE https://api.meridian.dev/v1/invoiceItems/ii_ItemId \
  -u sk_test_4eC39HqL...:

List Invoice Items

GET /v1/invoiceItems

Filter by customer or invoice.