iplookupapi.com Documentation

# Status Endpoint

Returns your current quota and the plan of your account.

Quota

Requests to this endpoint do not count against your quota or rate limit

Request Method: GET
Request URL: https://api.iplookupapi.com/v1/status

# Request Parameters

Parameter Type Mandatory Description
apikey string ️ Your API Key

# Sample Response

{
    "account_id": 313373133731337,
    "account_id_str": "313373133731337",
    "quotas": {
        "month": {
            "total": 150,
            "used": 72,
            "remaining": 78
        },
        "grace": {
            "total": 0,
            "used": 0,
            "remaining": 0
        }
    },
    "plan": {
        "name": "free",
        "interval": "month",
        "price_id": "price_1LNIQ2KszEJd98nk6DswpzXk",
        "free": true,
        "custom": false,
        "status": "active",
        "renews_at": "2026-11-01T00:00:00+00:00",
        "scheduled": null,
        "upgrade_url": "https://app.iplookupapi.com/upgrade?utm_source=agent&utm_campaign=status&team=313373133731337",
        "plans_url": "https://api.iplookupapi.com/v1/agent/plans"
    }
}
Field Description
account_id The ID of your account
account_id_str The same ID as a string, for JavaScript clients, whose numbers lose precision above 2^53
quotas.month Your monthly request quota: the plan's total, how much you used and how much is remaining
quotas.grace Your grace quota, see below
plan The plan of your account: name, interval, price_id, free, custom, status (of the subscription, e.g. active), renews_at, scheduled (a plan change that starts later, or null), upgrade_url (null for a custom plan) and plans_url (every plan as JSON). Use it to check that an upgrade took effect

Grace quota

The grace quota is a temporary allowance we grant while a payment is still pending (for example after a failed renewal), so your integration keeps working without interruption. In normal operation all of its values are 0. While you are consuming grace quota, the monthly quota response headers are replaced by x-ratelimit-limit-grace-month / x-ratelimit-remaining-grace-month.

← Info Endpoint →