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

# Persona natural

> Consulta de antecedentes de persona natural: documentos, fuentes e informe.

Usa el [POST del servicio](/consulta-antecedentes) con tipo y número de documento. Las fuentes de persona natural se consultan juntas en esa solicitud.

<Info>
  Flujo, créditos, omitidas y errores HTTP están en [Consulta de antecedentes](/consulta-antecedentes).
</Info>

## Request

```bash theme={"system"}
curl -sS -X POST "https://apis.ecorpa.com/v2/consulta/antecedentes" \
  -H "Authorization: Bearer ecorpa_key_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "AceptarTerminos": true,
    "Consultas": [
      {
        "TipoDocumentoIdentificacion": "CC",
        "NumeroIdentificacion": "1020304050",
        "FechaExpedicionDocumentoIdentidad": "17/12/2009"
      }
    ]
  }'
```

### Campos

| Campo                                           | Tipo   | Obligatorio | Descripción                                          |
| ----------------------------------------------- | ------ | ----------- | ---------------------------------------------------- |
| `Consultas[].TipoDocumentoIdentificacion`       | string | Sí          | Código del tipo de documento                         |
| `Consultas[].NumeroIdentificacion`              | string | Sí          | Solo dígitos `0-9`                                   |
| `Consultas[].FechaExpedicionDocumentoIdentidad` | string | No          | Formato `dd/mm/yyyy`. Si viene mal, el ítem se omite |

<Note>
  `FechaExpedicionDocumentoIdentidad` es opcional. Si no la envías, la solicitud igual se crea, pero las fuentes que la requieren no se consultan. [Más información](https://ecorpa.com)
</Note>

## Tipos de documento

| Código | Nombre                |
| ------ | --------------------- |
| `CC`   | Cédula de Ciudadanía  |
| `CE`   | Cédula de Extranjería |
| `PA`   | Pasaporte             |
| `PE`   | Permiso Especial      |
| `PT`   | Protección Temporal   |

<Note>
  No todas las fuentes aceptan todos los tipos. El detalle de qué documento aplica en cada fuente está en la web de ECORPA. [Más información](https://ecorpa.com)
</Note>

## Resultado

Cuando el ítem está `completado` pueden venir `PorcentajeConfianza`, `TieneHallazgos`, `RequiereRevision`, `InformePdf` y `Fuentes`.

```json theme={"system"}
{
  "TipoDocumentoIdentificacion": "CC",
  "NumeroIdentificacion": "1020304050",
  "NombreCompleto": "Sin identificar",
  "Estado": "completado",
  "PorcentajeConfianza": 95,
  "TieneHallazgos": true,
  "EstadoInforme": "listo",
  "InformePdf": "https://…",
  "Fuentes": [
    {
      "Nombre": "…",
      "Categoria": "Judicial",
      "Estado": "completado",
      "TieneNovedad": false,
      "Nivel": "sin novedad",
      "Mensaje": "Sin antecedentes judiciales",
      "Evidencias": [
        {
          "Titulo": "Evidencia",
          "Url": "https://…"
        }
      ]
    }
  ]
}
```

`EstadoInforme`: `pendiente` | `generando` | `listo` | `error`.

`PorcentajeConfianza` va de 0 a 100. Es un indicador consolidado; no reemplaza leer `Fuentes` ni el informe.

### Fuentes

| Campo          | Significado                                    |
| -------------- | ---------------------------------------------- |
| `Nombre`       | Fuente consultada                              |
| `Categoria`    | Clasificación de esa fuente                    |
| `Estado`       | `completado` \| `procesando` \| `indisponible` |
| `TieneNovedad` | Si hubo novedad                                |
| `Nivel`        | Nivel del hallazgo                             |
| `Mensaje`      | Texto corto                                    |
| `Evidencias`   | Lista `{ Titulo, Url }`                        |

<div className="result-info-cards">
  <CardGroup cols={1}>
    <Card title="Cómo leer el resultado" icon="book-open" href="https://ecorpa.com">
      Qué significan confianza, hallazgos, niveles y el informe.

      **Más información →**
    </Card>

    <Card title="Fuentes" icon="list" href="https://ecorpa.com">
      Qué fuentes se consultan.

      **Más información →**
    </Card>

    <Card title="Fuentes que requieren fecha de expedición" icon="calendar" href="https://ecorpa.com">
      Si no envías `FechaExpedicionDocumentoIdentidad`, esas fuentes no se consultan.

      **Más información →**
    </Card>

    <Card title="Tipos de documento por fuente" icon="id-card" href="https://ecorpa.com">
      No todas las fuentes consultan todos los tipos de documento.

      **Más información →**
    </Card>
  </CardGroup>
</div>


## Related topics

- [Consulta de antecedentes](/consulta-antecedentes.md)
- [Inicio](/index.md)