---
title: "POST /v1/InstalledAddOns/{InstalledAddOnSid}/Usage"
method: POST
path: "/v1/InstalledAddOns/{InstalledAddOnSid}/Usage"
tags: ["MarketplaceBillingUsage"]
---

# POST /v1/InstalledAddOns/{InstalledAddOnSid}/Usage

`POST /v1/InstalledAddOns/{InstalledAddOnSid}/Usage`

## Request

- Base URL: `https://marketplace.twilio.com`
- URL: `https://marketplace.twilio.com/v1/InstalledAddOns/{InstalledAddOnSid}/Usage`
- Auth: HTTP basic

Allows Twilio Marketplace publishers to manually report customer usage on No-code Partner Listings that they own.

## Path parameters

- `InstalledAddOnSid` string, required

## Request body

- MarketplaceV1InstalledAddOnInstalledAddOnUsage
  - `total_submitted` number: Total amount in local currency that was billed in this request. Aggregates all billable_items that were successfully submitted.
  - `billable_items` object[], required
    - `quantity` number, required: Total amount in local currency that was billed for this Billing Item. Can be any floating number greater than 0.
    - `sid` string, required: BillingSid to use for billing.
    - `submitted` boolean: Whether the billing event was successfully generated for this Billable Item.

## Response `202`

Accepted

- MarketplaceV1InstalledAddOnInstalledAddOnUsage
  - `total_submitted` number: Total amount in local currency that was billed in this request. Aggregates all billable_items that were successfully submitted.
  - `billable_items` object[], required
    - `quantity` number, required: Total amount in local currency that was billed for this Billing Item. Can be any floating number greater than 0.
    - `sid` string, required: BillingSid to use for billing.
    - `submitted` boolean: Whether the billing event was successfully generated for this Billable Item.

## Changes

- **2024-09-18** (v1) `ee8b741cf8e3`: 5 info
  - the response optional property `billable_items/items/submitted` became read-only for the status `202`
  - the response optional property `total_submitted` became read-only for the status `202`
  - the response property `billable_items` became required for the status `202`
  - the response property `billable_items/items/quantity` became required for the status `202`
  - …1 more
- **2024-08-26** (v1) `66592148b971`: 1 breaking
  - the request property `billable_items` became required
- **2024-06-27** (v1) `e78ce03aa4f1`: 1 info
  - api operation id `CreateMarketplaceBillingUsage` removed and replaced with `CreateBillingUsage`

[Operation history](https://skmtc.dev/twilio/apis/marketplace-v1/changes/v1/InstalledAddOns/:InstalledAddOnSid/Usage/post.md)

---

[API](https://skmtc.dev/twilio/apis/marketplace-v1.md) - [All operations](https://skmtc.dev/twilio/apis/marketplace-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/marketplace-v1/revisions/390602042b6e?raw)