> Every page of the Heythere docs is listed in https://heythere.io/docs/llms.txt: fetch it to find a page instead of guessing its URL.

# Usage: see what each workspace consumes on WhatsApp

> Read how many WhatsApp conversations and how much AI each workspace of your organization used in a month, to bill each of your clients for it.

Studio Nord, an agency, builds WhatsApp automations for its clients, with one workspace for each in its [organization](https://heythere.io/docs/concepts/organizations-and-workspaces): the repair shop where Camille takes her bike, a bakery, a florist. In December, it bills each client for what their workspace used in November. Usage counts two things for each workspace: its billed conversations and what its AI cost.

## What is a billed conversation?

One starts when WhatsApp reports the first message delivered to a contact, and covers the messages delivered to that contact on that number for 24 hours, up to 50. When the shop tells Camille at 10 a.m. that her bike is ready, then answers her questions until noon, that is one billed conversation. A message delivered the next day at 11 a.m., or the 51st of the day, starts another.

Only messages that reach the contact count. A message that ends `failed` is never billed, and neither are the contact's own messages nor a [test](https://heythere.io/docs/concepts/tests), which messages only a member's own phone.

## What does AI cost?

Every request a workspace's [AI](https://heythere.io/docs/concepts/ai) makes, in its automations and in its tests, in US dollars, at the AI provider's listed prices. The [workspace log](https://heythere.io/docs/concepts/workspace-log) shows each request with its cost.

## How does an agent read usage?

Only an administrator of the organization reads it. `getOrganizationUsage` gives its totals for a period, such as November, from `2026-11-01T00:00:00Z` to `2026-12-01T00:00:00Z`, and `listOrganizationWorkspaceUsage` gives each workspace's share, which Studio Nord bills to that client. WhatsApp can report a delivery up to 7 days late, so Studio Nord reads November once December 7 has passed. A deleted workspace keeps its usage, without its name. Heythere keeps usage 13 months.

## In the API

Every operation is a REST endpoint and, unless marked REST only, an MCP tool of the same name. [The OpenAPI document](https://app.heythere.io/api/openapi.json) describes their parameters, payloads, and errors.


- `getOrganizationUsage`: Get an organization's usage. `GET /api/organizations/{organizationId}/usage`
- `listOrganizationWorkspaceUsage`: List each workspace's usage. `GET /api/organizations/{organizationId}/usage/workspaces`
