---
title: "GET /api/projects/{project_id}/data_modeling_usage/"
method: GET
path: "/api/projects/{project_id}/data_modeling_usage/"
tags: ["data_modeling_usage"]
---

# GET /api/projects/{project_id}/data_modeling_usage/

`GET /api/projects/{project_id}/data_modeling_usage/`

## Request

- Base URL: `https://us.posthog.com`
- URL: `https://us.posthog.com/api/projects/{project_id}/data_modeling_usage/`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, required

## Query parameters

- `days` integer
- `page` integer
- `page_size` integer

## Response `200`

- ModelUsage
  - `date_from` string, date, required: Inclusive UTC start date.
  - `date_to` string, date, required: Exclusive UTC end date. Today's incomplete usage is excluded.
  - `overview` ModelUsageTotals, required
    - `runs` integer, required: Finished ClickHouse materialization runs, including failures and cancellations.
    - `measured_runs` integer, required: Runs with recorded usage. Other runs have unknown cost.
    - `read_bytes` integer, nullable, required: Measured bytes read, including probes and retries. Null if unmeasured.
    - `read_rows` integer, nullable, required: Measured rows read. Null if unmeasured.
    - `cpu_microseconds` integer, nullable, required: Measured CPU microseconds. Null if unmeasured.
    - `query_count` integer, nullable, required: Measured ClickHouse query count. Null if unmeasured.
  - `trends` ModelUsageDay[], required: Daily usage, attributed to when each run finished.
    - `runs` integer, required: Finished ClickHouse materialization runs, including failures and cancellations.
    - `measured_runs` integer, required: Runs with recorded usage. Other runs have unknown cost.
    - `read_bytes` integer, nullable, required: Measured bytes read, including probes and retries. Null if unmeasured.
    - `read_rows` integer, nullable, required: Measured rows read. Null if unmeasured.
    - `cpu_microseconds` integer, nullable, required: Measured CPU microseconds. Null if unmeasured.
    - `query_count` integer, nullable, required: Measured ClickHouse query count. Null if unmeasured.
    - `day` string, date, required: UTC day on which the runs finished.
  - `models` ModelUsageRow[], required: Model breakdown, highest measured bytes first.
    - `runs` integer, required: Finished ClickHouse materialization runs, including failures and cancellations.
    - `measured_runs` integer, required: Runs with recorded usage. Other runs have unknown cost.
    - `read_bytes` integer, nullable, required: Measured bytes read, including probes and retries. Null if unmeasured.
    - `read_rows` integer, nullable, required: Measured rows read. Null if unmeasured.
    - `cpu_microseconds` integer, nullable, required: Measured CPU microseconds. Null if unmeasured.
    - `query_count` integer, nullable, required: Measured ClickHouse query count. Null if unmeasured.
    - `saved_query_id` string, uuid, nullable, required: Model ID, or null if permanently deleted.
    - `name` string, required: Model name.
    - `deleted` boolean, required: Whether this model has been deleted.
  - `count` integer, required: Total number of models in the breakdown.
  - `usage_updated_at` string, date-time, nullable, required: Latest usage collection timestamp in this range.

## Changes

> 53 revisions in range; 1 not diffed.

- **2026-10-23** `993f70ab941b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/posthog/apis/posthog-api/changes/api/projects/:project_id/data_modeling_usage/get.md)

---

[API](https://skmtc.dev/posthog/apis/posthog-api.md) · [All operations](https://skmtc.dev/posthog/apis/posthog-api/llms.txt) · [OpenAPI document](https://skmtc.dev/posthog/apis/posthog-api/revisions/993f70ab941b?raw)