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

POST /v1/InstalledAddOns/{InstalledAddOnSid}/Usage
Account sid auth token

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

Path parameters

  • InstalledAddOnSid string Required

    Customer Installation SID to report usage on.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^XE[0-9a-fA-F]{32}$.

application/json

Body Required

  • billable_items array[object] Required
    Hide billable_items attributes Show billable_items attributes object
    • 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.

Responses

  • 202 application/json

    Accepted

    Hide response attributes Show response attributes object
    • total_submitted number

      Total amount in local currency that was billed in this request. Aggregates all billable_items that were successfully submitted.

    • billable_items array[object] Required
      Hide billable_items attributes Show billable_items attributes object
      • 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.
POST /v1/InstalledAddOns/{InstalledAddOnSid}/Usage 
curl \
 --request POST 'https://marketplace.twilio.com/v1/InstalledAddOns/BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage' \
 --user "username:password" \
 --header "Content-Type: application/json" \
 --data '{"billable_items":[{"sid":"BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","quantity":12.355},{"sid":"BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","quantity":44.02}]}'
Request example 
{
  "billable_items": [
    {
      "sid": "BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "quantity": 12.355
    },
    {
      "sid": "BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "quantity": 44.02
    }
  ]
}
Response examples (202) 
{
  "billable_items": [
    {
      "sid": "BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "quantity": 12.355,
      "submitted": false
    },
    {
      "sid": "BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "quantity": 44.02,
      "submitted": true
    }
  ],
  "total_submitted": 44.02
}