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

# Analizar entidad

> Ejecuta un análisis manual de riesgo con el motor de reglas sobre una entidad existente en el modelo universal gu1 de KYC, KYB y compliance.

## Descripción general

Dispara manualmente el análisis de riesgo de una entidad usando la matriz de riesgo y reglas configuradas. Opcionalmente enriquece la entidad antes del análisis.

## Endpoint

```
POST http://api.gu1.ai/entities/{entityId}/analyze
```

## Cuerpo de la solicitud

<ParamField body="entityType" type="string" required>
  Tipo de entidad: `person`, `company` o `transaction`
</ParamField>

<ParamField body="rulesEngineConfig" type="object">
  Comportamiento del motor en esta corrida. Campos opcionales (default `false`):

  * **`partialCoverage`:** con varias matrices asignadas, cobertura **por matriz**; las que no tienen datos se omiten.
  * **`omitCoverage`:** omite todos los gates de cobertura (entidad principal y accionistas). Prevalece sobre `partialCoverage`.
</ParamField>

## Ejemplo — cobertura parcial por matriz

```bash theme={null}
curl -X POST http://api.gu1.ai/entities/entity-123/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityType": "company",
    "rulesEngineConfig": { "partialCoverage": true }
  }'
```

## Ver también

* [Analyze Entity (EN)](/en/api-reference/entities/analyze)