---
title: "GET /v1/projects/{projectOrProductUID}/usage/api"
method: GET
path: "/v1/projects/{projectOrProductUID}/usage/api"
tags: ["usage"]
---

# GET /v1/projects/{projectOrProductUID}/usage/api

`GET /v1/projects/{projectOrProductUID}/usage/api`

## Request

- Base URL: `https://api.notefile.net`
- URL: `https://api.notefile.net/v1/projects/{projectOrProductUID}/usage/api`
- Auth: HTTP bearer

Get billable Notehub API request usage for a project, broken down by endpoint and time period, when endDate is 0 or unspecified the current time is implied. Only requests that are billed against the project's plan are counted

## Path parameters

- `projectOrProductUID` string, required

## Query parameters

- `startDate` integer
- `endDate` integer
- `limit` integer
- `period` 'day' | 'week' | 'month', required

## Response `200`

Response body for Notehub API request usage

- object
  - `data` UsageApiData[], required
    - `endpoint` string: The templated path of the endpoint the requests were made against, with path parameters left unsubstituted. Empty if the endpoint could not be resolved for these requests.
    - `method` string: The HTTP method of the requests counted in this data point. Empty if the endpoint could not be resolved for these requests.
    - `period` string, date-time, required
    - `requests` integer, required: Number of billable API requests in this period.
  - `truncated` boolean: If the data is truncated that means that the parameters selected resulted in a response of over | the requested limit of data points, in order to ensure

## Other responses

- `default`: The response body in case of an API error.

## Changes

- **2026-10-09** `9e0f164783d4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/notefile/apis/notehub-api/changes/v1/projects/:projectOrProductUID/usage/api/get.md)

---

[API](https://skmtc.dev/notefile/apis/notehub-api.md) - [All operations](https://skmtc.dev/notefile/apis/notehub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/notefile/apis/notehub-api/revisions/85336e2859bc?raw)