---
title: "List billable feature usage logs"
method: GET
path: "/v1/usage"
tags: ["v1"]
---

# List billable feature usage logs

`GET /v1/usage`

Returns a paginated list of billable feature usage logs for your organization. Each entry represents a token consumption event (e.g. a dive, rank radar creation, AI copywriter prompt). Optionally filter by feature type, user name/email, and date range.

## Query parameters

- `type` 'DIVED_ASINS' | 'PRODUCT_BRIEF_ASINS' | 'AI_COPYWRITER_PROMPTS' | 'RANK_RADAR_KEYWORDS' | 'INDEXING_DIAGNOSIS'
- `search` string
- `startDate` string
- `endDate` string
- `currentPage` number
- `pageSize` number

## Response `200`

- ExternalUsageLogListDto
  - `currentPage` number, required
  - `pageSize` number, required — Number of items per page
  - `hasNext` boolean, required — True when there is a next page. Otherwise, false
  - `hasPrev` boolean, required — True when there is a previous page. Otherwise, false
  - `lastPage` number, required — Last page or total page count
  - `total` number, required — Total number of items
  - `data` ExternalUsageLogDto[], required — List of items
    - `name` string, nullable, required — Name of the user who performed the action
    - `email` string, required — Email of the user who performed the action
    - `qty` number, required — Number of tokens consumed
    - `type` 'DIVED_ASINS' | 'PRODUCT_BRIEF_ASINS' | 'AI_COPYWRITER_PROMPTS' | 'RANK_RADAR_KEYWORDS' | 'INDEXING_DIAGNOSIS', required — The billable feature type
    - `action` 'RANK_RADAR_PAUSE' | 'RANK_RADAR_CREATE' | 'RANK_RADAR_UPDATE' | 'RANK_RADAR_RESUMED' | 'RANK_RADAR_ARCHIVE' | 'RANK_RADAR_KEYWORD_PAUSE' | 'RANK_RADAR_KEYWORD_UNPAUSE' | 'DIVE_SCHEDULED' | 'DIVE_DIVEBOX' | 'SOLO_REVERSE_ASIN' | 'REFUND_FAILED_SOLO_REVERSE_ASIN' | 'REFUND_FAILED_DIVE' | 'ANALYZE_COMPETITORS' | 'ANALYZE_COMPETITORS_FAILED' | 'INDEXING_DIAGNOSIS' | 'INDEXING_DIAGNOSIS_FAILED' | 'AI_GENERATE_DESCRIPTION' | 'AI_GENERATE_BULLETS' | 'AI_GENERATE_ITEM_HIGHLIGHTS' | 'AI_GENERATE_LISTING' | 'MANUAL_KEYWORD_ADD' | 'MANUAL_KEYWORD_REMOVE', nullable, required — Specific action performed
    - `nicheId` string, nullable, required — Associated Niche identifier
    - `nicheName` string, nullable, required — Associated Niche name
    - `rankRadarId` string, nullable, required — Associated Rank Radar identifier
    - `date` string, date-time, required — When the usage was recorded

## Other responses

- `400` — Invalid query parameters
- `401` — Api key is invalid
- `403` — Unauthorized to access the resource
- `404` — Resource not found
- `429` — Rate limit exceeded, either the per-client-IP limit or the per-API-key limit for this endpoint.
- `500` — Internal error

---

[API](https://skmtc.dev/datadive/apis/data-dive-developer-apis.md) · [All operations](https://skmtc.dev/datadive/apis/data-dive-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datadive/data-dive-developer-apis/revisions/03207abc96ba/schema)