Standardizes invoice line item IDsBreaking changes
What’s new
Changes the id field of all invoice line items, prefixing them with il_
. The new ID has consistent prefixes across all line items, is globally unique, and can be used for pagination. Old prefixes included sub_
, su_
, item_
, sli_
, and ii_
and weren`t globally unique.
- You can no longer use the prefix of the ID to determine the source of the line item. Instead use the
type
field for this purpose. - For lines with
type=invoiceitem
, use theinvoice_
field to reference or update the originatingitem Invoice Item
object. - On earlier API versions, the
Invoice Line Item
object also has aunique_
field that you can use to migrate internal references before upgrading to this version.id - When setting a tax rate to individual line items, use the new
id
. If you’re on an earlier API version, pass in either a line itemid
orunique_
.id
Impact
Lets you work with a more consistent and globally unique invoice line item ID format. The new IDs are prefixed with “il_” instead of various legacy prefixes, providing a standardized approach across all line items.