Skip to main content
GET
/
v1
/
usage
/
history
List usage history
curl --request GET \
  --url https://api.reader.dev/v1/usage/history \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "data": [
    {
      "id": "<string>",
      "url": "<string>",
      "duration": 123,
      "status": "success",
      "cached": true,
      "proxyMode": "standard",
      "credits": 123,
      "error": "<string>",
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "total": 1234,
    "skip": 0,
    "limit": 20,
    "hasMore": true,
    "next": "https://api.reader.dev/v1/jobs/abc?skip=20&limit=20"
  }
}
Paginated log of recent requests for the workspace. Each entry records the URL, duration, status, cache hit, proxy mode (standard / stealth), credits charged, and timestamp. Use this endpoint to audit spend, find spike culprits, or build a stats dashboard. The dashboard’s Activity view is a thin wrapper on top of this feed.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
skip
integer
Required range: x >= 0
​
limit
integer
Required range: 1 <= x <= 100

Response

200 - application/json

Paginated usage history

​
success
enum<boolean>
required
Available options:
true
​
data
object[]
required
​
pagination
object
required