Usage

Retrieve usage statistics for your API key, including request counts, endpoint breakdowns, and recent request history. Supports cursor-based pagination.

Endpoint

GET /usage

Query parameters

Parameter	Type	Required	Description
limit	number	No	Maximum number of records to return (1-100, default 100)
cursor	string	No	Pagination cursor from a previous response’s next_cursor field

Request

No request body. Authentication via X-API-Key header.

curl https://mcll3bnfubyazfg6wekv3xc6fi0dgpyk.lambda-url.us-east-1.on.aws/usage \
  -H "X-API-Key: YOUR_API_KEY"

With pagination

curl "https://mcll3bnfubyazfg6wekv3xc6fi0dgpyk.lambda-url.us-east-1.on.aws/usage?limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

# Fetch next page using cursor from previous response
curl "https://mcll3bnfubyazfg6wekv3xc6fi0dgpyk.lambda-url.us-east-1.on.aws/usage?limit=5&cursor=CURSOR_VALUE" \
  -H "X-API-Key: YOUR_API_KEY"

Response

Field	Type	Description
total_requests	number	Total requests in this page
requests_by_endpoint	object	Request count per endpoint
requests_today	number	Requests made today (UTC)
recent_requests	array	Last 20 requests (newest first)
rate_limit	object	Current rate limit status
next_cursor	string	Pagination cursor for the next page (omitted when no more results)

Recent request object

Field	Type	Description
endpoint	string	API endpoint path
timestamp	string	ISO 8601 timestamp
latency_ms	number	Request duration in milliseconds
status	number	HTTP status code

Example response

{
  "total_requests": 5,
  "requests_by_endpoint": {
    "/analyze_outfit": 3,
    "/try_on_outfit": 1,
    "/style_me": 1
  },
  "requests_today": 3,
  "recent_requests": [
    {
      "endpoint": "/analyze_outfit",
      "timestamp": "2026-02-28T14:32:01.000Z",
      "latency_ms": 3200,
      "status": 200
    },
    {
      "endpoint": "/try_on_outfit",
      "timestamp": "2026-02-28T14:28:45.000Z",
      "latency_ms": 18500,
      "status": 200
    }
  ],
  "rate_limit": {
    "daily_limit": 20,
    "used_today": 5,
    "remaining": 15
  },
  "next_cursor": "eyJhcGlfa2V5IjoiLi4uIiwidGltZXN0YW1wIjoiLi4uIn0"
}

Notes

• Usage data is tracked automatically for every authenticated request
• The recent_requests array returns the most recent 20 requests from the current page
• Usage statistics are per API key, not per user
• Use limit and cursor to paginate through large result sets
• You can also view usage in the Developer Portal