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

# External API de ChainPatrol para bloquear URLs y direcciones de estafas

> Índice de todos los endpoints de la External API de ChainPatrol para quienes integran la Blocklist: verificación de assets, reportes, takedowns, métricas y datos de la organización.

Trabajamos con los principales navegadores, antivirus, apps de seguridad, marketplaces y wallets para
bloquear enlaces de estafa, direcciones de contratos y direcciones de wallets antes de que un usuario
interactúe con la estafa. La API también permite a los clientes llevar todos los datos de amenazas de
ChainPatrol —**Suspected Threats** (amenazas sospechosas detectadas automáticamente, todavía sin
confirmar), reportes, **Takedowns** (solicitudes de baja de contenido fraudulento) y cambios en la
**Blocklist** (lista de bloqueo)— directamente a su propio SOC para un monitoreo centralizado.
Las API de ChainPatrol se ofrecen como un servicio gratuito para navegadores, antivirus, apps de
seguridad, marketplaces y wallets.

Todos los endpoints que aparecen a continuación se sirven desde `https://app.chainpatrol.io/api/v2`.
La mayoría necesita una clave de API; consulta [Autenticación de la External API](https://chainpatrol.com/docs/es/external-api/authentication.md) para ver
cómo enviarla. Algunas consultas públicas, como [Verificar asset](https://chainpatrol.com/docs/es/external-api/asset-check.md) y
[Listar assets](https://chainpatrol.com/docs/es/external-api/asset-list.md), también responden sin ella.
Consulta la [Política de obsolescencia de la API](https://chainpatrol.com/docs/es/external-api/deprecation-policy.md) para saber cómo versionamos
la API y cómo te avisamos de los cambios incompatibles (breaking changes).

Los agentes pueden cargar esta documentación desde [llms.txt](https://chainpatrol.com/docs/llms.txt).

## Empieza aquí

> [card] [Crear reporte](https://chainpatrol.com/docs/es/external-api/report-create.md)
>
> Presenta un reporte contra una estafa.

> [card] [Cómo crear reportes](https://chainpatrol.com/docs/es/external-api/creating-reports.md)
>
> Guía de todo el flujo de reporte, incluida la carga de archivos de evidencia.

> [card] [Verificar asset](https://chainpatrol.com/docs/es/external-api/asset-check.md)
>
> Comprueba si un **Asset** (activo digital: URL, dirección, perfil, app, etc.) está permitido o
> bloqueado.

> [card] [Listar assets](https://chainpatrol.com/docs/es/external-api/asset-list.md)
>
> Obtén nuestra **Allowlist** (lista de permitidos) y nuestra Blocklist completas para usarlas en
> tu propia aplicación.

> [card] [Obtener historial de cambios de assets](https://chainpatrol.com/docs/es/external-api/asset-changelog.md)
>
> Obtén los cambios más recientes de nuestra Allowlist/Blocklist.

> [card] [Crear disputa](https://chainpatrol.com/docs/es/external-api/dispute-create.md)
>
> Crea una disputa por un asset que fue marcado incorrectamente.

> [card] [Configurar webhook](https://chainpatrol.com/docs/es/external-api/webhook-config.md)
>
> Recibe notificaciones en tiempo real en lugar de consultar periódicamente (polling).

## Assets

Consulta, envía, escanea, desbloquea y sigue assets individuales.

> [card] [Verificar asset](https://chainpatrol.com/docs/es/external-api/asset-check.md)
>
> Comprueba si un asset está permitido o bloqueado.

> [card] [Listar assets](https://chainpatrol.com/docs/es/external-api/asset-list.md)
>
> Obtén la Allowlist/Blocklist completa.

> [card] [Obtener historial de cambios de assets](https://chainpatrol.com/docs/es/external-api/asset-changelog.md)
>
> Obtén los cambios recientes de la Allowlist/Blocklist.

> [card] [Buscar assets](https://chainpatrol.com/docs/es/external-api/asset-search.md)
>
> Busca entre los assets.

> [card] [Obtener conexiones de assets](https://chainpatrol.com/docs/es/external-api/asset-connections.md)
>
> Qué llevó a un asset y a dónde lleva, como assets vinculados.

> [card] [Enviar asset](https://chainpatrol.com/docs/es/external-api/asset-submit.md)
>
> Envía un asset para revisión.

> [card] [Desbloquear asset](https://chainpatrol.com/docs/es/external-api/asset-unblock.md)
>
> Desbloquea uno de tus assets o abre una disputa.

> [card] [Analizar asset](https://chainpatrol.com/docs/es/external-api/asset-parse.md)
>
> Convierte contenido sin procesar en tipos de asset de ChainPatrol.

> [card] [Iniciar Asset Scan](https://chainpatrol.com/docs/es/external-api/asset-scan.md)
>
> Inicia un **Asset Scan** (escaneo de un asset), opcionalmente con una URL de callback.

> [card] [Obtener resultado del escaneo](https://chainpatrol.com/docs/es/external-api/scan-result.md)
>
> Recupera los enriquecimientos, las comprobaciones y las etiquetas de un escaneo.

> [card] [Obtener detalles del asset](https://chainpatrol.com/docs/es/external-api/asset-details.md)
>
> Obsoleto: usa Verificar asset o Buscar assets.

> [card] [Seguir asset](https://chainpatrol.com/docs/es/external-api/asset-follow.md)
>
> Recibe un correo cuando cambie el estado de un asset o se complete su takedown.

> [card] [Dejar de seguir asset](https://chainpatrol.com/docs/es/external-api/asset-unfollow.md)
>
> Deja de recibir los correos sobre un asset.

> [card] [Listar assets seguidos](https://chainpatrol.com/docs/es/external-api/asset-follows-list.md)
>
> Consulta todos los assets que sigues, con su estado y su takedown.

## Reportes

> [card] [Cómo crear reportes](https://chainpatrol.com/docs/es/external-api/creating-reports.md)
>
> Guía paso a paso para presentar un reporte, con archivos de evidencia adjuntos.

> [card] [Crear reporte](https://chainpatrol.com/docs/es/external-api/report-create.md)
>
> Presenta un reporte contra una estafa.

> [card] [Subir archivo adjunto](https://chainpatrol.com/docs/es/external-api/attachment-upload.md)
>
> Sube archivos de evidencia (`.eml`, capturas de pantalla, PDF) y obtén una URL para adjuntarla a un reporte.

> [card] [Buscar reportes](https://chainpatrol.com/docs/es/external-api/reports-search.md)
>
> Comprueba si ya existe un reporte antes de crear uno nuevo.

## Disputas

> [card] [Crear disputa](https://chainpatrol.com/docs/es/external-api/dispute-create.md)
>
> Disputa un asset que fue marcado incorrectamente.

## Webhooks

> [card] [Configurar webhook](https://chainpatrol.com/docs/es/external-api/webhook-config.md)
>
> Recibe notificaciones en tiempo real sobre actualizaciones de estado de assets y nuevas Suspected Threats.

## Marcas de la organización

> [card] [Listar marcas de la organización](https://chainpatrol.com/docs/es/external-api/organization-brands.md)
>
> Lista todas las marcas de tu organización, con términos, tickers, documentos legales y
> **Trademark Registrations** (registros de marca).

## Assets de la organización

Administra los assets y los grupos de assets que pertenecen a tu organización.

> [card] [Listar assets de la organización](https://chainpatrol.com/docs/es/external-api/organization-assets-list.md)
>
> Lista los assets de tu organización.

> [card] [Agregar assets a la organización](https://chainpatrol.com/docs/es/external-api/organization-assets-add.md)
>
> Agrega un asset a tu organización.

> [card] [Actualizar asset de la organización](https://chainpatrol.com/docs/es/external-api/organization-assets-update.md)
>
> Actualiza un asset de la organización.

> [card] [Quitar asset de la organización](https://chainpatrol.com/docs/es/external-api/organization-assets-remove.md)
>
> Quita un asset de la organización.

> [card] [Listar grupos de assets de la organización](https://chainpatrol.com/docs/es/external-api/organization-asset-groups-list.md)
>
> Lista los grupos de assets de tu organización.

> [card] [Crear grupo de assets de la organización](https://chainpatrol.com/docs/es/external-api/organization-asset-groups-create.md)
>
> Crea un grupo de assets.

> [card] [Actualizar grupo de assets de la organización](https://chainpatrol.com/docs/es/external-api/organization-asset-groups-update.md)
>
> Actualiza un grupo de assets.

> [card] [Eliminar grupo de assets de la organización](https://chainpatrol.com/docs/es/external-api/organization-asset-groups-delete.md)
>
> Elimina un grupo de assets.

## Reportes de la organización

> [card] [Listar reportes de la organización](https://chainpatrol.com/docs/es/external-api/organization-reports-list.md)
>
> Obtén los reportes de tu organización (`GET /organization/reports`).

> [card] [Obtener reportes de la organización (obsoleto)](https://chainpatrol.com/docs/es/external-api/organization-reports.md)
>
> Obsoleto: usa Listar reportes de la organización.

## Detección de amenazas

Lista las Suspected Threats, inspecciona sus fuentes y administra las configuraciones de detección que las encuentran.

> [card] [Listar suspected threats](https://chainpatrol.com/docs/es/external-api/detection-list.md)
>
> Lista los resultados sin confirmar de la detección automática.

> [card] [Listar fuentes de detección](https://chainpatrol.com/docs/es/external-api/detection-sources-list.md)
>
> Descubre las fuentes que puedes configurar y los esquemas de sus configuraciones.

> [card] [Listar configuraciones de detección](https://chainpatrol.com/docs/es/external-api/detection-configs-list.md)
>
> Lista las fuentes de detección y sus configuraciones.

> [card] [Crear configuración de detección](https://chainpatrol.com/docs/es/external-api/detection-configs-create.md)
>
> Crea una nueva configuración para una fuente.

> [card] [Actualizar configuración de detección](https://chainpatrol.com/docs/es/external-api/detection-configs-update.md)
>
> Cambia el estado, la programación o los campos de una configuración.

> [card] [Eliminar configuración de detección](https://chainpatrol.com/docs/es/external-api/detection-configs-delete.md)
>
> Elimina una configuración con alcance de organización para que deje de escanear.

> [card] [Ejecutar configuraciones de detección](https://chainpatrol.com/docs/es/external-api/detection-configs-run.md)
>
> Ejecuta una o varias configuraciones bajo demanda.

> [card] [Validar configuraciones de detección](https://chainpatrol.com/docs/es/external-api/detection-configs-validate.md)
>
> Comprueba las configuraciones contra sus resultados recientes.

> [card] [Obtener señales de desviación de detección](https://chainpatrol.com/docs/es/external-api/detection-drift.md)
>
> Saca a la luz las configuraciones sin resultados, ruidosas y desactualizadas.

> [card] [Listar amenazas](https://chainpatrol.com/docs/es/external-api/threats-list.md)
>
> Lista las amenazas de tu organización.

## Dark Web

Busca credenciales filtradas de los objetivos que una marca ya tiene en seguimiento.

> [card] [Listar objetivos de credenciales en la dark web](https://chainpatrol.com/docs/es/external-api/dark-web-credentials-targets.md)
>
> Encuentra los dominios de correo, las direcciones de correo y las direcciones de wallet disponibles para buscar.

> [card] [Buscar credenciales en la dark web](https://chainpatrol.com/docs/es/external-api/dark-web-credentials-search.md)
>
> Busca credenciales filtradas vinculadas a un objetivo en seguimiento.

## Takedowns

> [card] [Listar takedowns](https://chainpatrol.com/docs/es/external-api/takedowns-list.md)
>
> Lista los takedowns de tu organización.

## Métricas

> [card] [Obtener resumen de métricas](https://chainpatrol.com/docs/es/external-api/metrics-summary.md)
>
> Métricas orientadas al cliente y desgloses de amenazas bloqueadas para un rango de fechas.

> [card] [Obtener desglose de métricas](https://chainpatrol.com/docs/es/external-api/metrics-breakdown.md)
>
> Cantidad de amenazas bloqueadas, agrupadas por día, tipo de asset o marca.

> [card] [Obtener conteo de amenazas encontradas](https://chainpatrol.com/docs/es/external-api/metrics-found.md)
>
> La métrica `found` predeterminada: amenazas nuevas orientadas al cliente.

> [card] [Obtener amenazas bloqueadas por origen del primer reporte](https://chainpatrol.com/docs/es/external-api/metrics-found-by-source.md)
>
> Cantidad de amenazas bloqueadas, separadas según quién las reportó primero: tú o ChainPatrol.

> [card] [Listar métricas de la organización](https://chainpatrol.com/docs/es/external-api/organization-metrics-list.md)
>
> Obtén las métricas de tu organización (`GET /organization/metrics`).

> [card] [Obtener métricas de la organización (obsoleto)](https://chainpatrol.com/docs/es/external-api/organization-metrics.md)
>
> Obsoleto: usa Listar métricas de la organización.

## Cuenta y acceso

> [card] [Validar clave de API](https://chainpatrol.com/docs/es/external-api/validate.md)
>
> Comprueba si una clave de API es válida.

> [card] [Obtener el usuario actual](https://chainpatrol.com/docs/es/external-api/user-me.md)
>
> Detalles del usuario autenticado.

> [card] [Actualizar el usuario actual](https://chainpatrol.com/docs/es/external-api/user-me-update.md)
>
> Actualiza el perfil y la configuración del usuario autenticado.

> [card] [Listar organizaciones del usuario](https://chainpatrol.com/docs/es/external-api/user-orgs.md)
>
> Organizaciones a las que puede acceder quien hace la llamada, con servicios e integraciones.

> [card] [Obtener una organización del usuario](https://chainpatrol.com/docs/es/external-api/user-orgs-get.md)
>
> Obtén una sola organización por su slug.

## Operaciones

> [card] [Obtener instantánea de las colas de operaciones](https://chainpatrol.com/docs/es/external-api/operations-queues-snapshot.md)
>
> Estado de las colas pendientes de revisión y de takedowns, con segmentos por SLA y antigüedad.

## Healthchecks

Los healthchecks (verificaciones de estado) evalúan una sola señal operativa y todos devuelven la
misma estructura de resultado, así que puedes llamarlos en un bucle y procesar las respuestas con
código compartido. Empieza por el registro:

> [card] [Listar healthchecks](https://chainpatrol.com/docs/es/external-api/healthchecks-list.md)
>
> El registro de healthchecks disponibles: llama solo a aquellos en los que `implemented` sea
> true.

Las verificaciones individuales:

* [Configuraciones de detección silenciosas](https://chainpatrol.com/docs/es/external-api/healthchecks-detections-silent-configs.md) —
  configuraciones habilitadas que producen muy pocos resultados recientes
* [Backlog de revisión](https://chainpatrol.com/docs/es/external-api/healthchecks-reviewing-backlog.md) — acumulación de
  **Proposals** (propuestas para bloquear o permitir un asset) sin revisar
* [Proposals antiguas en revisión](https://chainpatrol.com/docs/es/external-api/healthchecks-reviewing-old-proposals.md) —
  Proposals que llevan esperando más allá de los umbrales de antigüedad
* [Volumen de Takedowns en TODO](https://chainpatrol.com/docs/es/external-api/healthchecks-takedowns-todo-volume.md) — acumulación de
  takedowns en `TODO`
* [Volumen de Takedowns en IN\_PROGRESS](https://chainpatrol.com/docs/es/external-api/healthchecks-takedowns-in-progress-volume.md) —
  acumulación de takedowns en `IN_PROGRESS`
* [Takedowns estancados en IN\_PROGRESS](https://chainpatrol.com/docs/es/external-api/healthchecks-takedowns-stale-in-progress.md) —
  takedowns detenidos más allá del umbral de estancamiento
* [Cantidad de Takedowns cancelados](https://chainpatrol.com/docs/es/external-api/healthchecks-takedowns-cancelled-count.md) — exceso
  de cancelaciones en una ventana móvil
* [Takedowns automatizados desactivados](https://chainpatrol.com/docs/es/external-api/healthchecks-takedowns-automation-off.md) —
  automatización apagada durante demasiado tiempo
* [Pico de assets inactivos](https://chainpatrol.com/docs/es/external-api/healthchecks-assets-dead-asset-spike.md) — pico de assets
  detectados como inactivos (`DEAD`)
* [URL de contacto faltante](https://chainpatrol.com/docs/es/external-api/healthchecks-organization-missing-contact-url.md) — no hay
  un canal principal de comunicación configurado

> [!NOTE]
>
> Dos endpoints `POST` están obsoletos y se mantienen solo por compatibilidad con versiones anteriores:
> [`/public/getOrganizationReports`](https://chainpatrol.com/docs/es/external-api/organization-reports) —usa
> [`GET /organization/reports`](https://chainpatrol.com/docs/es/external-api/organization-reports-list)— y
> [`/public/getOrganizationMetrics`](https://chainpatrol.com/docs/es/external-api/organization-metrics) —usa
> [`GET /organization/metrics`](https://chainpatrol.com/docs/es/external-api/organization-metrics-list)—.
> [`POST /asset/details`](https://chainpatrol.com/docs/es/external-api/asset-details) está marcado como obsoleto en la propia especificación.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.