---
title: "List your usage"
method: GET
path: "/v1/usage"
tags: ["Account"]
---

# List your usage

`GET /v1/usage`

## Request

- Base URL: `https://platform.detectif.ai`
- URL: `https://platform.detectif.ai/v1/usage`
- Auth: HTTP bearer

Lists your detection, enrollment and verification requests with their outcome and the credits they used, newest first. Filter by `operation` or `status`; page with `limit` and `cursor`. Requires scope `usage:read`.

## Query parameters

- `limit` integer: How many entries to return (1-100).
- `cursor` string, nullable: `next_cursor` from the previous page.
- `operation` 'deepfake.detect' | 'speaker.enroll' | 'speaker.verify' | 'noesis.stream' | 'noesis.file', nullable: Only this kind of request.
- `status` 'succeeded' | 'rejected' | 'failed' | 'replayed', nullable: Only requests with this outcome.

## Response `200`

Success.

- UsageList
  - `request_id` string, required
  - `object` 'list', required
  - `data` UsageEvent[], required
    - `id` string, required
    - `operation_id` string, nullable, required
    - `type` 'deepfake.detect' | 'speaker.enroll' | 'speaker.verify' | 'noesis.stream' | 'noesis.file', required
    - `source` 'api' | 'dashboard' | 'mcp', required
    - `status` 'succeeded' | 'rejected' | 'failed' | 'replayed', required
    - `http_status` integer, required
    - `error_code` string, nullable, required
    - `credits_charged` integer, required
    - `duration_seconds` number, nullable, required
    - `latency_ms` number, nullable, required
    - `request_id` string, required
    - `created_at` string, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: The request is invalid, for example a missing or malformed field.
- `401`: The API key is missing, invalid or revoked.
- `403`: The key lacks the required scope, the email address is not verified, or the account is suspended.
- `429`: Too many requests or too many operations at the same time. Wait for the number of seconds in Retry-After.
- `500`: Something went wrong on our side. No credits were used.

---

[API](https://skmtc.dev/detectif/apis/detectifai-developer-api.md) · [All operations](https://skmtc.dev/detectif/apis/detectifai-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/detectif/apis/detectifai-developer-api/revisions/24295482ed77?raw)