---
title: "Get Organization Usage"
method: POST
path: "/api/organization/usage/{organization_id}"
tags: ["Organization"]
---

# Get Organization Usage

`POST /api/organization/usage/{organization_id}`

Fetch the current usage specification of an organization by its id. Auth'ed user or api key must have an admin or owner role for the specified dataset's organization.

## Path parameters

- `organization_id` string, uuid, required

## Headers

- `TR-Organization` string, uuid, required

## Request body

- GetOrganizationUsageReqPayload
  - `date_range` DateRange — DateRange is a JSON object which can be used to filter chunks by a range of dates. This leverages the time_stamp field on chunks in your dataset. You can specify this if you want values in a certain range. You must provide ISO 8601 combined date and time without timezone.
    - `gt` string, nullable
    - `gte` string, nullable
    - `lt` string, nullable
    - `lte` string, nullable
  - `v1_usage` boolean, nullable

## Response `200`

The current usage of the specified organization

- ExtendedOrganizationUsageCount
  - `bytes_ingested` integer, required
  - `chunk_count` integer, required
  - `current_months_message_count` integer, required
  - `dataset_count` integer, required
  - `events_ingested` integer, required
  - `file_storage` integer, required
  - `message_count` integer, required
  - `message_tokens` integer, required
  - `ocr_pages_ingested` integer, required
  - `search_count` integer, required
  - `search_tokens` integer, required
  - `tokens_ingested` integer, required
  - `user_count` integer, required
  - `website_pages_scraped` integer, required

## Other responses

- `400` — Service error relating to finding the organization's usage by id

---

[API](https://skmtc.net/devflowinc/apis/trieve-api.md) · [All operations](https://skmtc.net/devflowinc/apis/trieve-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/devflowinc/trieve-api/revisions/84583e7c9fc1/schema)