Get quota

curl https://api.pocketutils.com/v1/quota \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch("https://api.pocketutils.com/v1/quota", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const { data } = await res.json();

import requests

res = requests.get(
    "https://api.pocketutils.com/v1/quota",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
data = res.json()["data"]

{
  "success": true,
  "data": {
    "callerKind": "apikey",
    "plan": "STARTER",
    "limit": 5000,
    "remaining": 4312
  }
}

{
  "success": true,
  "data": {
    "callerKind": "anonymous",
    "limit": 10,
    "remaining": 7
  }
}

GET

quota

curl https://api.pocketutils.com/v1/quota \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch("https://api.pocketutils.com/v1/quota", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const { data } = await res.json();

import requests

res = requests.get(
    "https://api.pocketutils.com/v1/quota",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
data = res.json()["data"]

{
  "success": true,
  "data": {
    "callerKind": "apikey",
    "plan": "STARTER",
    "limit": 5000,
    "remaining": 4312
  }
}

{
  "success": true,
  "data": {
    "callerKind": "anonymous",
    "limit": 10,
    "remaining": 7
  }
}

Returns the current credit balance for whoever is calling — anonymous, signed-in, or an API key. This is the same data that powers the credits bar on pocketutils.com. It’s free to call, uncached, and doesn’t count toward your rate limit’s credit spend (it still counts as a request).

Headers

Authorization

string

Bearer pu_live_.... Omit entirely to check the anonymous allowance for your IP instead.

Response

The shape of data depends on the caller. Both share callerKind, limit, and remaining; a signed-in caller additionally gets plan.

success

boolean

required

Always true for this endpoint.

data

object

required

Hide properties

callerKind

string

required

One of "anonymous", "session", "apikey".

plan

string

"FREE", "STARTER", "GROWTH", "SCALE", or "ENTERPRISE". Omitted when callerKind is "anonymous".

limit

integer

required

Total credits available this cycle (or, for anonymous, per day).

remaining

integer

required

Credits left. For a signed-in caller this is cycle credits plus any unused top-up credits combined.

curl https://api.pocketutils.com/v1/quota \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch("https://api.pocketutils.com/v1/quota", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const { data } = await res.json();

import requests

res = requests.get(
    "https://api.pocketutils.com/v1/quota",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
data = res.json()["data"]

{
  "success": true,
  "data": {
    "callerKind": "apikey",
    "plan": "STARTER",
    "limit": 5000,
    "remaining": 4312
  }
}

{
  "success": true,
  "data": {
    "callerKind": "anonymous",
    "limit": 10,
    "remaining": 7
  }
}

Getting Started

API Reference

Headers

Response

​Headers

​Response

Headers

Response