Retrieve a Line Item

curl -X GET "https://api.chartmogul.com/v1/line_items/li_b86028e7-c28c-4a0f-9518-fbbdbc259824" \
     -u YOUR_API_KEY:

{
  "uuid": "li_b86028e7-c28c-4a0f-9518-fbbdbc259824",
  "external_id": "li_ext_id_00762",
  "type": "subscription",
  "amount_in_cents": 10000,
  "quantity": 1,
  "discount_code": "",
  "discount_amount_in_cents": 0,
  "tax_amount_in_cents": 0,
  "transaction_fees_in_cents": 0,
  "account_code": "",
  "plan_uuid": "pl_5a86bf58-1934-4ccf-9de1-537efa6dd166",
  "plan_external_id": "gold_plan",
  "transaction_fees_currency": null,
  "discount_description": null,
  "event_order": 3,
  "balance_transfer": false,
  "subscription_uuid": "sub_a918d070-3bad-4ddb-8bff-eb8804481d9c",
  "subscription_external_id": "sub_ext_id_00081",
  "prorated": false,
  "proration_type": "full",
  "service_period_start": "2025-06-14T21:39:06.000Z",
  "service_period_end": "2025-07-14T21:39:06.000Z",
  "subscription_set_external_id": "set_ext_id_00012",
  "disabled": false,
  "disabled_at": null,
  "disabled_by": null,
  "user_created": true,
  "edit_history_summary":
    {
        "values_changed":
        {
            "service_period_end":
            {
                "original_value": "2025-07-31T21:39:06.000Z",
                "edited_value": "2025-07-14T21:39:06.000Z"
            },
            "amount_in_cents":
            {
                "original_value": 11000,
                "edited_value": 10000
            }
        },
        "latest_edit_author": "[email protected]",
        "latest_edit_performed_at": "2025-08-04T12:36:50.574Z"
    }
}

Path parameters

line_item_uuid string optional

The ChartMogul UUID of the line item to be retrieved. If provided, this value is used to identify the line item.

Query parameters

external_id string optional

A unique external identifier of the line item that you want to retreive. Required together with data_source_uuid if line_item_uuid is not provided.

data_source_uuid string optional

The ChartMogul UUID of the data source the line item belongs to. Required together with external_id if line_item_uuid is not provided.

validation_type string optional default: "valid"

The validation type of the line items to be retrieved. Accepts the following values: valid, invalid and all. Based on this value, returns valid, invalid or both valid and invalid line items. The default value is valid.

include_edit_histories boolean optional default: false

Specifies whether the response should contain the edit_history_summary object with a summary of user edits for automatic sources (Stripe, Chargebee, Recurly, Braintree, Google Play, App Store Connect and SaaSync integrations).

with_disabled boolean optional default: false

Specifies whether the response should contain disabled line item.

Response

The response contains the requested line item object:

uuid

The UUID of the line_item object generated by ChartMogul.

external_id

The unique external identifier for this line item, as specified by you.

type

The type of line item, one of subscription, one_time or trial, as specified by you.

On October 2, 2025, we introduced trial as an invoice line item type. We’re gradually making the functionality available to all accounts. Learn more.

amount_in_cents

The amount in cents charged toward this line item for the specified service period, after discounts and taxes have been applied, as specified by you.

quantity

The quantity of this line item being billed.

discount_code

A reference code for any discount applied to this line item, as specified by you.

discount_amount_in_cents

The discount amount in cents for this line item, as specified by you.

tax_amount_in_cents

The tax amount in cents for this line item, as specified by you.

transaction_fees_in_cents

The transaction fees in cents for this line item, as specified by you.

account_code

The accounting code for the line item, as specified by you.

plan_uuid

The UUID of the plan object associated with the above subscription object, generated by ChartMogul.

plan_external_id

The unique identifier for the plan associated with this invoice. Typically an identifier from your internal system.

transaction_fees_currency

The transaction fees currency for this line item, as specified by you.

discount_description

The discount amount in cents description for this line item, as specified by you.

event_order

A numeric value that determines the sequence in which events are processed when multiple events occur at the same timestamp, as specified by you.

balance_transfer

A boolean stating whether or not this represents a value returned to customer balance.

subscription_uuid

The UUID of the subscription object generated by ChartMogul.

subscription_set_external_id

An optional unique external identifier for the subscription set to which this subscription belongs, as specified by you.

subscription_external_id

The unique external identifier for this subscription, as specified by you.

prorated

A boolean stating whether or not this is a prorated charge for the subscription object, as specified by you.

proration_type

A string defining the type of proration, with possible values differential, full or differential_mrr.

service_period_start

The start of the service period for which the subscription is being charged, as specified by you.

service_period_end

The end of the service period for which the subscription is being charged, as specified by you.

description

A short description of the one_time line item being charged to the customer, as specified by you.

disabled

A boolean stating whether or not the line item was disabled.

disabled_at

The date and time when the line item was disabled (null for non-disabled records).

disabled_by

The email address of the user who disabled the line item (null for non-disabled records).

user_created

A boolean stating whether or not the line item was created by the user for one of the automatic sources (Stripe, Chargebee, Recurly, Braintree, Google Play, App Store Connect and SaaSync integrations).

edit_history_summary

A summary of edits made to the line item, available when you set the include_edit_histories query parameter to true. The object is empty if the invoice and line item belong to a source not supporting data edits.

The summary contains the following properties:

values_changed

The object with the list of edited or added peroperties. Each property that has been edited or added is represented as an object with its original_value and edited_value.

latest_edit_author

The email address of the user who made the most recent edit to the line item.

latest_edit_performed_at

The timestamp when the most recent edit was made, in ISO 8601 format.