Límites y facturación

El mismo modelo para toda la API. Cada superficie tiene sus valores, pero las reglas — cómo se cuenta, qué factura y qué no — son idénticas.

Rate-limit

Cada API Key tiene un límite de solicitudes por minuto (ventana fija) por producto. Al excederlo, la API responde 429 con retryAfterMs (milisegundos hasta que la ventana se reinicia):

{ "statusCode": 429, "message": "Rate limit excedido", "retryAfterMs": 4200 }

Cuota

Además del rate-limit hay una cuota por período (diaria/mensual) por API Key + producto. Al agotarla, la API responde 429 (sin pista de retry):

{ "statusCode": 429, "message": "Cuota diaria excedida (DAILY, límite 1000)" }

Valores por defecto

Superficie	Rate-limit	Cuota	Precio de lista
Person Search	60 req/min	1000 consultas/día	1.00 USD por consulta
Fuentes — consulta	60 req/min	1000 consultas/día	0.25 USD (LOCAL) · 0.50 USD (LIVE)
Fuentes — catálogo	60 req/min	—	no factura
Email Validation	por API Key	por API Key	1 request ejecutado
Phone Validation	por API Key	por API Key	1 request del nivel completado

Los valores concretos de tu key los define tu plan; los de la tabla son los del catálogo por defecto. El precio aplicado a cada consulta viaja en la respuesta como cost.

TIP

No hay cabecera Retry-After. Para el rate-limit, respetá retryAfterMs del cuerpo; para la cuota, reintentá en el próximo período.

Facturación

La unidad facturable es 1 request ejecutado. En los endpoints de resolución, eso significa una consulta con estado SUCCEEDED o PARTIAL.

No facturan:

• los rechazos previos a la ejecución: validación (400), autenticación (401), autorización (403), rate-limit y cuota (429);
• las consultas que fallan por completo a nivel técnico;
• el catálogo de fuentes (GET /api/v1/sources), que es metadata.

Sí facturan, porque se ejecutaron:

• una consulta PARTIAL (una fuente LIVE falló pero el resto se sirvió);
• una búsqueda válida sin resultados (subjects: []);
• un email INVALID o UNKNOWN (el pipeline corrió).

En Phone Validation la unidad es el nivel completado: si pediste HLR y el número resolvió sólo hasta MNP, no se factura por encima de MNP; LOCAL y CHECKMOBI_VERIFY no facturan.

El precio comercial aplicado viaja en la respuesta como cost ({ amount, currency }) o null si la consulta no es facturable. El uso de caché puede reducir el costo técnico interno, pero no cambia el precio comercial.

Ver también: Errores.