--- title: "Retrieve Line Item" method: GET path: "/organizations/{orgId}/bills/{billId}/lineitems/{id}" tags: ["Bill"] --- # Retrieve Line Item `GET /organizations/{orgId}/bills/{billId}/lineitems/{id}` Retrieves a specific line item within a Bill. This endpoint retrieves the line item given by its unique identifier (UUID) from a specific Bill. ## Path parameters - `orgId` string, required - `billId` string, required - `id` string, required ## Query parameters - `additional` string[] ## Response `200` Returns the requested line item from a Bill - BillLineItemResponse - `id` string, required — The UUID of the entity. - `version` integer — The version number: - **Create:** On initial Create to insert a new entity, the version is set at 1 in the response. - **Update:** On successful Update, the version is incremented by 1 in the response. - `lineItemType` 'STANDING_CHARGE' | 'USAGE' | 'COUNTER_RUNNING_TOTAL_CHARGE' | 'COUNTER_ADJUSTMENT_DEBIT' | 'COUNTER_ADJUSTMENT_CREDIT' | 'USAGE_CREDIT' | 'MINIMUM_SPEND' | 'MINIMUM_SPEND_REFUND' | 'CREDIT_DEDUCTION' | 'MANUAL_ADJUSTMENT' | 'CREDIT_MEMO' | 'DEBIT_MEMO' | 'COMMITMENT_CONSUMED' | 'COMMITMENT_FEE' | 'OVERAGE_SURCHARGE' | 'OVERAGE_USAGE' | 'BALANCE_CONSUMED' | 'BALANCE_FEE' | 'AD_HOC' — See [Bill Line Item Types](https://www.m3ter.com/docs/guides/running-viewing-and-managing-bills/bill-line-item-types) for more information. - `productId` string - `description` string - `servicePeriodStartDate` string, date-time - `servicePeriodEndDate` string, date-time - `referencedBillId` string - `referencedLineItemId` string - `dtCreated` string, date-time — The DateTime when the line item was created. - `dtLastModified` string, date-time — The DateTime when the line item was last modified. - `createdBy` string — The ID of the user who created this line item. - `lastModifiedBy` string — The ID of the user who last modified this line item. - `productName` string — The name of the Product associated with this line item. - `productCode` string — The code of the Product associated with this line item. - `accountingProductId` string — The unique identifier (UUID) for the associated Accounting Product. - `accountingProductName` string — The name of the Accounting Product associated with this line item. - `accountingProductCode` string — The code of the Accounting Product associated with this line item. - `aggregationId` string — A unique identifier (UUID) for the Aggregation that contributes to this Bill line item. - `compoundAggregationId` string — A unique identifier (UUID) for the Compound Aggregation, if applicable. - `counterId` string — The unique identifier (UUID) for the Counter associated with this line item. - `chargeId` string — The unique identifier (UUID) for the Charge associated with this line item. - `segment` object — Specifies the segment name or identifier when segmented Aggregation is used. This is relevant for more complex billing structures. - `group` object - `meterId` string — The unique identifier (UUID) of the Meter responsible for tracking usage. - `planId` string — A unique identifier (UUID) for the billing Plan associated with this line item. - `planGroupId` string — The unique identifier (UUID) of the Plan Group associated with this line item. - `commitmentId` string — The unique identifier (UUID) of the Commitment associated with this line item. - `balanceId` string — The unique identifier (UUID) for the Balance associated with this line item. - `billId` string — The unique identifier (UUID) for the Bill that includes this line item. - `quantity` number — The amount of the product or service used in this line item. - `units` number — The number of units rated in the line item, each of which is of the type specified in the `unit` field. For example: 400 api_calls. In this example, the unit type of **api_calls** is read from the `unit` field. - `unit` string — Specifies the unit type. For example: **MB**, **GB**, **api_calls**, and so on. - `subtotal` number — The subtotal amount when not currency converted *(in the cases where currency conversion is required)*. - `currency` string — The currency in which the line item is billed, represented as a currency code. For example, USD, GBP, or EUR. - `conversionRate` number — The currency conversion rate *(if used)* for the line item. - `convertedSubtotal` number — The subtotal amount for this line item after currency conversion, if applicable. - `creditTypeId` string — The unique identifier (UUID) for the type of credit applied to this line item. - `pricingId` string — The unique identifier (UUID) of the Pricing used for this line item, - `bandUsage` BillLineItemPricingBandUsage[] — Array containing the pricing band information, which shows the details for each pricing band or tier. - `pricingBandId` string — The UUID for the pricing band. - `lowerLimit` number, double — The lower limit *(start)* of the pricing band. - `fixedPrice` number — Fixed price is a charge entered for certain pricing types such as Stairstep, Custom Tiered, and Custom Volume. It is a set price and not dependent on usage. - `unitSubtotal` number — The subtotal of the unit usage. - `unitPrice` number — The price per unit in the band. - `bandUnits` number — The number of units used within the band. - `bandQuantity` number — Usage amount within the band. - `bandSubtotal` number — Subtotal amount for the band. - `creditTypeId` string — The UUID of the credit type. - `convertedBandSubtotal` number - `reasonId` string — A unique identifier (UUID) for the reason or justification for this line item, if applicable. - `contractId` string — The unique identifier (UUID) for the Contract associated with this line item. - `jsonUsageGenerated` boolean — Boolean flag indicating whether the Bill line item has associated statement usage in JSON format. When a Bill statement is generated, usage line items have their usage stored in JSON format. - `averageUnitPrice` number — Represents the average unit price calculated across all pricing bands or tiers for this line item. - `sequenceNumber` integer — The line item sequence number. - `additional` object ## Other responses - `4XX` — Error message - `5XX` — Error message ## Changes - **2025-12-03** `ac93d1a9e6d9` — 11 warning, 2 info - removed the optional property `allOf[subschema #2 -> subschema #3]/createdBy` from the response with the `200` status - removed the optional property `allOf[subschema #2 -> subschema #3]/description` from the response with the `200` status - removed the optional property `allOf[subschema #2 -> subschema #3]/dtCreated` from the response with the `200` status - removed the optional property `allOf[subschema #2 -> subschema #3]/dtLastModified` from the response with the `200` status - …9 more - **2025-08-01** `9f9e5f3dbde7` — 1 breaking, 7 info - the response property `allOf[#/components/schemas/AbstractResponse]/version` became optional for the status `200` - added the new optional `query` request parameter `additional` - added the optional property `allOf[subschema #2]/accountingProductCode` to the response with the `200` status - added the optional property `allOf[subschema #2]/accountingProductId` to the response with the `200` status - …4 more - **2025-03-03** `9beb1e1df3bd` — 1 info - added the optional property `allOf[subschema #2]/group` to the response with the `200` status - **2025-02-04** `9433593378b5` — 1 warning - removed the optional property `allOf[subschema #2]/chargeableItemId` from the response with the `200` status [Change history](https://skmtc.dev/m3ter-com/apis/m3ter-api/changes/organizations/:orgId/bills/:billId/lineitems/:id/get.md) --- [API](https://skmtc.dev/m3ter-com/apis/m3ter-api.md) · [All operations](https://skmtc.dev/m3ter-com/apis/m3ter-api/llms.txt) · [OpenAPI document](https://skmtc.dev/m3ter-com/apis/m3ter-api/revisions/ac93d1a9e6d9?raw)