> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creditbenchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Referencia de la API

> Autentíquese, resuelva entidades, consulte datos, realice análisis y descubra metadatos a través de la API REST de Credit Benchmark.

Las API de Credit Benchmark proporcionan acceso programático a la resolución de entidades, datos sin procesar a nivel de entidad, análisis calculados y metadatos para su integración en flujos de trabajo de riesgo y procesos de generación de informes. Todas las rutas son relativas a `https://gateway.creditbenchmark.com`.

<Tip title="Inicio rápido">
  Autentíquese con `POST /api/security/token`. Si ya dispone de `CB_ID` , omita la resolución de entidades y vaya directamente a `POST /analytics/v2/data/getdata` o a las rutas de análisis indicadas a continuación. `/analytics/v2/data/`.
</Tip>

## Cómo funciona

<Steps>
  <Step title="Obtenga un token">
    Realice la llamada `POST /api/security/token` con su `Username` y `Password`Reutilice el token de portador devuelto hasta que caduque.
  </Step>

  <Step title="Resuelva las entidades (si es necesario)">
    Si sus datos de origen utilizan nombres de empresas en lugar de identificadores CB, realice una llamada `POST /matching/text/match_external` para resolverlos. Conserve los identificadores coincidentes como `CB_ID` valores para las llamadas de análisis.
  </Step>

  <Step title="Consulte los campos disponibles">
    Realice una llamada `GET /analytics/v2/metadata/columns` para consultar los campos, tipos de datos y permisos disponibles antes de construir las solicitudes.
  </Step>

  <Step title="Consultar análisis">
    Comience con `POST /analytics/v2/data/getdata` para obtener resultados a nivel de fila. Utilice los puntos finales de análisis específicos para tendencias, desgloses, cambios de calificación y distribuciones.
  </Step>

  <Step title="Descubra los metadatos">
    Utilice las rutas de metadatos que se encuentran en `/analytics/v2/metadata/` para consultar las columnas disponibles, las escalas de calificación, los esquemas sectoriales y geográficos, y las fechas de vigencia.
  </Step>
</Steps>