Sign in

v10

latestOpenAPI 3.0.1raw.githubusercontent.com2025-12-033223581.2 MB
Debits

Create Debit Line Item

Create a new Debit line item for the given bill.

When creating Debit line items for Bills, use the Debit Reasons created for your Organization. See DebitReason.

post/organizations/{orgId}/bills/{billId}/debitlineitems

Path parameters

orgIdstring required

UUID of the Organization. The Organization represents your company as a direct customer of the m3ter service.

billIdstring required

UUID of the bill.

Request body

versioninteger

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.
reasonIdstring

The UUID of the line item reason.

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 for more information.

amountToApplyOnBillnumber
productIdstring required

The UUID of the Product.

accountingProductIdstring required
descriptionstring required

The description for the line item.

amountnumber required

The amount for the line item.

referencedBillIdstring required

The UUID of the bill for the line item.

referencedLineItemIdstring required

The UUID of the line item.

servicePeriodStartDatestring date-time required

The service period start date in ISO-8601 format. (inclusive of the starting date).

servicePeriodEndDatestring date-time required

The service period end date in ISO-8601 format.(exclusive of the ending date).

debitReasonIdstring

The ID of the Debit Reason given for this debit line item.

Response

Returns the new debit line item

idstring required

The UUID of the entity.

versioninteger

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 for more information.

productIdstring
descriptionstring
servicePeriodStartDatestring date-time
servicePeriodEndDatestring date-time
referencedBillIdstring
referencedLineItemIdstring
dtCreatedstring date-time

The DateTime when the line item was created.

dtLastModifiedstring date-time

The DateTime when the line item was last modified.

createdBystring

The ID of the user who created this line item.

lastModifiedBystring

The ID of the user who last modified this line item.

amountnumber
debitReasonIdstring

The UUID of the debit reason for this debit line item.