---
title: "Me Usage Recent"
method: GET
path: "/api/auth/me/usage/recent"
tags: ["auth"]
---

# Me Usage Recent

`GET /api/auth/me/usage/recent`

## Request

- Base URL: `https://api.halalterminal.com`
- URL: `https://api.halalterminal.com/api/auth/me/usage/recent`
- Auth: API key in header `X-API-Key`

Return the most recent individual requests for the *calling* API key.

Path-clean replacement for `/api/keys/{api_key}/usage/recent`.

**curl example**:
```bash
curl -H "X-API-Key: ht_abc123"       "https://api.halalterminal.com/api/auth/me/usage/recent?limit=10"
```

## Query parameters

- `limit` integer: Maximum number of recent requests to return.

## Response `200`

Most recent individual requests for the calling key

- RecentRequestsResponse: List of the most recent API requests for a key.
  - `api_key` string, required: The API key these requests belong to
  - `requests` RecentRequestEntry[], required: Recent API request log entries
    - `endpoint` string, required: API endpoint that was called
    - `method` string, required: HTTP method used
    - `status_code` integer, nullable: HTTP status code returned
    - `tokens_charged` integer: Tokens charged for this request
    - `timestamp` string, required: ISO-8601 timestamp of the request

## Other responses

- `401`: Missing or invalid API key
- `422`: Validation Error

---

[API](https://skmtc.dev/halalterminal/apis/halal-terminal-api.md) · [All operations](https://skmtc.dev/halalterminal/apis/halal-terminal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/halalterminal/apis/halal-terminal-api/revisions/78768b250943?raw)