---
title: "Query and filter for bill line items."
method: POST
path: "/organizations/{orgId}/dataexplorer/bills"
tags: ["DataExplorer"]
---

# Query and filter for bill line items.

`POST /organizations/{orgId}/dataexplorer/bills`

Query and filter for bill line items.

## Path parameters

- `orgId` string, required

## Request body

- QueryBillDataRequest
  - `version` integer — The version number of the entity: - **Create entity:** Not valid for initial insertion of new entity - *do not use for Create*. On initial Create, version is set at 1 and listed in the response. - **Update Entity:** On Update, version is required and must match the existing version because a check is performed to ensure sequential versioning is preserved. Version is incremented by 1 and listed in the response.

## Response `200`

Returns a list of bill line items.

- BillDataResponse — Response containing bill line items.
  - `values` BillData[] — A list of bill line items.
    - `updatedDate` string, date-time
    - `dimensions` LineItemDimensions
      - `account` string
      - `accountName` string
      - `accountId` string
      - `parentAccountCode` string
      - `parentAccountName` string
      - `parentAccountId` string
      - `childAccountId` string
      - `description` string
      - `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.
      - `productName` string
      - `quantityUnit` string
      - `subtotalUnit` string
      - `convertedSubtotalUnit` string
      - `billId` string
      - `externalInvoiceReference` string
      - `commitmentId` string
      - `billLineItemId` string
    - `measures` LineItemMeasures
      - `convertedSubtotal` number, double
      - `subtotal` number, double
      - `version` number, double
      - `conversionRate` number, double
      - `quantity` number, double
      - `units` number, double
    - `billDetails` BillDetails
      - `day` integer
      - `week` string
      - `year` integer
      - `month` string
      - `locked` string
      - `status` string
      - `dueDate` string
      - `startDate` string
      - `endDate` string
      - `servicePeriodStartDate` string
      - `servicePeriodEndDate` string
      - `billDate` string
      - `timezone` string
      - `yearMonth` string
      - `billCurrency` string
      - `billingFrequency` string

## Other responses

- `4XX` — Error message
- `5XX` — Error message

---

[API](https://skmtc.net/m3ter-com/apis/m3ter-api.md) · [All operations](https://skmtc.net/m3ter-com/apis/m3ter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/m3ter-com/m3ter-api/revisions/ac93d1a9e6d9/schema)