Leer el índice
GET /v1/qscore/index es público y no exige credenciales. Si omites
period, usa el trimestre UTC cerrado más reciente. Filtros opcionales:
Índice público
200 OK
items vienen ordenados por país, industria y banda. No hay paginación:
la respuesta es el snapshot filtrado.
Estados de respuesta, metodología y privacidad
Al cerrar cada trimestre se toma el último score de cada sujeto existente antes
del cierre. Se agrupa por país, industria y banda (
A, B, C, D, E o
SC). Solo se publica un bucket con al menos cinco sujetos. avg_score
es el promedio entero redondeado del bucket.
El índice es append-only por período y bucket. No es un score vivo de una
persona o empresa y no permite drill-down individual.
Consulta el catálogo de errores.
Equivalente autenticado
GET /v1/qscore/index/account devuelve el mismo snapshot y filtros para una
cuenta o scope de lectura admin autenticado. Una cuenta requiere el servicio
risk; los scopes administrativos no dependen del flag de una cuenta.
El índice no cobra, no emite webhook y no envía email.
Errores y FAQ
Un período inválido responde400 invalid_period; usa YYYY-Q1 a YYYY-Q4
y años entre 2020 y 9999.
¿Puedo identificar a un sujeto?
¿Puedo identificar a un sujeto?
No. Los buckets menores a cinco se omiten y nunca aparecen identificadores.
¿Sin período significa el trimestre actual?
¿Sin período significa el trimestre actual?
No. Significa el último trimestre UTC cerrado.
¿Puedo filtrar una industria?
¿Puedo filtrar una industria?
Sí, envía
industry_code junto con country y period.