Konto

Konto-API

Ihr Plan, Ihr Kontingent und was davon übrig ist.

Limits abrufen

GET/v1/user/limits

API-Schlüssel

Antwortfelder

accountTypestring
Name des Plans, etwa Free oder Pro.
limitinteger
In diesem Monat erlaubte Anfragen.
usageinteger
In diesem Monat verbrauchte Anfragen.
remaininginteger
In diesem Monat verbleibende Anfragen.
resetDatestring
Reset-Datum des Monatskontingents.
daily.limitinteger
Heute erlaubte Anfragen, bei Plänen mit Tageslimit.
daily.usedinteger
Heute verbrauchte Anfragen.
daily.remaininginteger
Heute verbleibende Anfragen.
daily.resetAtstring
Wann das Tagesfenster zurückgesetzt wird.
hourly.limitinteger
In dieser Stunde erlaubte Anfragen.
hourly.usedinteger
In dieser Stunde verbrauchte Anfragen.
hourly.remaininginteger
In dieser Stunde verbleibende Anfragen.
hourly.resetAtstring
Wann das Stundenfenster zurückgesetzt wird.

curl https://ipscanner.io/v1/user/limits \
  -H "Authorization: Bearer YOUR_API_KEY"

Antwort

{
  "accountType": "Free",
  "limit": 30000,
  "usage": 4180,
  "remaining": 25820,
  "resetDate": "2026-11-01",
  "daily": {
    "limit": 1000,
    "used": 212,
    "remaining": 788,
    "resetAt": "2026-10-07T00:00:00Z"
  },
  "hourly": {
    "limit": 100,
    "used": 14,
    "remaining": 86,
    "resetAt": "2026-10-06T15:00:00Z"
  }
}

Verbrauch abrufen

GET/v1/usage/summary

API-Schlüssel

Antwortfelder

planstring
Name des Plans.
usedinteger
In diesem Monat verbrauchte Anfragen.
limitinteger
In diesem Monat erlaubte Anfragen.
remaininginteger
In diesem Monat verbleibende Anfragen.
percentnumber
Verbrauchter Anteil des Monatskontingents.
unlimitedboolean
true bei Plänen ohne Monatslimit.
softBlockedboolean
true, wenn das Konto über einem Limit liegt.
blockedBystring
Welches Limit Sie blockiert: monthly, daily, hourly oder leer.
bulkCapinteger
Höchstzahl an Adressen pro Bulk-Aufruf in Ihrem Plan.
periodStartstring
Erster Tag des Abrechnungsmonats.
resetDatestring
Reset-Datum des Monatskontingents.

curl https://ipscanner.io/v1/usage/summary \
  -H "Authorization: Bearer YOUR_API_KEY"

Antwort

{
  "plan": "Free",
  "used": 4180,
  "limit": 30000,
  "unlimited": false,
  "remaining": 25820,
  "percent": 13.9,
  "softBlocked": false,
  "blockedBy": "",
  "upgradeHint": false,
  "bulkCap": 100,
  "daily": {
    "limit": 1000,
    "used": 212,
    "remaining": 788,
    "resetAt": "2026-10-07T00:00:00Z"
  },
  "hourly": {
    "limit": 100,
    "used": 14,
    "remaining": 86,
    "resetAt": "2026-10-06T15:00:00Z"
  },
  "periodStart": "2026-10-01",
  "resetDate": "2026-11-01",
  "asOf": "2026-10-06T14:05:00Z"
}