---
title: "Usage"
description: "Send usage events from your app and bill them through meters."
canonical_url: "https://twominutebilling.com/help/developers/api-reference/usage"
---
# Usage

> Send usage events from your app and bill them through meters.

Send usage events from your app and bill them through meters. An event names a customer by any key your app already has (a user, workspace or API key id) or by the customer id. Its own `key` makes every send safe to retry: a repeat is a duplicate and counts once.

A **meter** says what to count: an event name, an aggregation, optional filters and up to five group-by properties. A **price** on the meter bills each combination of group values from a rate card with a default rate, at up to 12 decimal places, or passes through the event's own amount or cost plus a markup. Usage closes about 6 minutes after a period ends; an event that arrives later bills on the next invoice as usage from its own period.

## Endpoints

<table>
<thead>
  <tr>
    <th>
      Method
    </th>
    
    <th>
      Endpoint
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/usage/usage-by-day-for-one-customer">
        <code>
          /v1/businesses/{biz}/customers/{cus}/usage
        </code>
      </a>
    </td>
    
    <td>
      Usage by day for one customer
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/usage/list-a-customer-s-usage-keys">
        <code>
          /v1/businesses/{biz}/customers/{cus}/usage_keys
        </code>
      </a>
    </td>
    
    <td>
      List a customer's usage keys
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/usage/add-a-usage-key">
        <code>
          /v1/businesses/{biz}/customers/{cus}/usage_keys
        </code>
      </a>
    </td>
    
    <td>
      Add a usage key
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/usage/remove-a-usage-key">
        <code>
          /v1/businesses/{biz}/customers/{cus}/usage_keys/remove
        </code>
      </a>
    </td>
    
    <td>
      Remove a usage key
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/usage/list-meters">
        <code>
          /v1/businesses/{biz}/meters
        </code>
      </a>
    </td>
    
    <td>
      List meters
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/usage/create-a-meter">
        <code>
          /v1/businesses/{biz}/meters
        </code>
      </a>
    </td>
    
    <td>
      Create a meter
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/usage/retrieve-a-meter">
        <code>
          /v1/businesses/{biz}/meters/{meter}
        </code>
      </a>
    </td>
    
    <td>
      Retrieve a meter
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        PATCH
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/usage/update-a-meter">
        <code>
          /v1/businesses/{biz}/meters/{meter}
        </code>
      </a>
    </td>
    
    <td>
      Update a meter
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/usage/archive-a-meter">
        <code>
          /v1/businesses/{biz}/meters/{meter}/archive
        </code>
      </a>
    </td>
    
    <td>
      Archive a meter
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/usage/list-usage-events">
        <code>
          /v1/businesses/{biz}/usage_events
        </code>
      </a>
    </td>
    
    <td>
      List usage events
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/usage/send-a-usage-event">
        <code>
          /v1/businesses/{biz}/usage_events
        </code>
      </a>
    </td>
    
    <td>
      Send a usage event
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/usage/send-up-to-500-usage-events">
        <code>
          /v1/businesses/{biz}/usage_events/batch
        </code>
      </a>
    </td>
    
    <td>
      Send up to 500 usage events
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/usage/void-a-usage-event">
        <code>
          /v1/businesses/{biz}/usage_events/void
        </code>
      </a>
    </td>
    
    <td>
      Void a usage event
    </td>
  </tr>
</tbody>
</table>


## Sitemap

See the full [sitemap](https://twominutebilling.com/sitemap.md) for all pages.