Cuenta

API de cuenta

Tu plan, tu cupo y lo que te queda.

Obtener tus límites

GET/v1/user/limits

Clave de API

Campos de la respuesta

accountTypestring
Nombre del plan, como Free o Pro.
limitinteger
Solicitudes permitidas este mes.
usageinteger
Solicitudes usadas este mes.
remaininginteger
Solicitudes que quedan este mes.
resetDatestring
Fecha en que se reinicia el cupo mensual.
daily.limitinteger
Solicitudes permitidas hoy, en planes con tope diario.
daily.usedinteger
Solicitudes usadas hoy.
daily.remaininginteger
Solicitudes que quedan hoy.
daily.resetAtstring
Cuándo se reinicia la ventana diaria.
hourly.limitinteger
Solicitudes permitidas esta hora.
hourly.usedinteger
Solicitudes usadas esta hora.
hourly.remaininginteger
Solicitudes que quedan esta hora.
hourly.resetAtstring
Cuándo se reinicia la ventana por hora.

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

Respuesta

{
  "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"
  }
}

Obtener tu consumo

GET/v1/usage/summary

Clave de API

Campos de la respuesta

planstring
Nombre del plan.
usedinteger
Solicitudes usadas este mes.
limitinteger
Solicitudes permitidas este mes.
remaininginteger
Solicitudes que quedan este mes.
percentnumber
Parte del cupo mensual usada.
unlimitedboolean
True en planes sin tope mensual.
softBlockedboolean
True cuando la cuenta supera un límite.
blockedBystring
Qué límite te bloquea: monthly, daily, hourly o vacío.
bulkCapinteger
Máximo de direcciones por llamada masiva en tu plan.
periodStartstring
Primer día del mes de facturación.
resetDatestring
Fecha en que se reinicia el cupo mensual.

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

Respuesta

{
  "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"
}