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

# Informe de verificación de ubicación: geolocation_checks

> Campos geolocation_checks y geolocation_attempts de Didit: posición, precisión, áreas, distancias, anonimizadores, consentimiento y advertencias.

## Descripción general

La decisión de la sesión devuelve el resultado de cada paso de verificación de ubicación en dos listas: `geolocation_checks[]` contiene el intento aceptado de cada paso y `geolocation_attempts[]` enumera todos los intentos en orden.
Ambas están en `GET /v3/session/{sessionId}/decision/` (consulta [Recuperar sesión](https://docs.didit.me/es/sessions-api/retrieve-session.md)) y en el webhook `status.updated`.
Un flujo de verificación (workflow) sin paso de ubicación devuelve `null` o una lista vacía en ambas.

```text theme={null}
GET /v3/session/{sessionId}/decision/
  --> { "geolocation_checks": [ { node_id, status, outcome, permission, latitude, longitude, accuracy_m, ... } ],
        "geolocation_attempts": [ { node_id, outcome, attempts, received_at, ... } ] }
```

## `geolocation_checks[]`

Un elemento por cada paso de ubicación (`node_id`), tomado de su intento más reciente.

```json theme={null}
{
  "node_id": "geolocation_1",
  "status": "Declined",
  "outcome": "outside_geofence",
  "permission": "granted_precise",
  "latitude": 48.8566,
  "longitude": 2.3522,
  "accuracy_m": 35.0,
  "accuracy_confidence": "p95",
  "measured_at": "2026-11-03T10:15:02Z",
  "age_seconds": 2,
  "source": "browser",
  "platform": "web",
  "sdk_version": null,
  "is_mock": null,
  "produced_by_accessory": null,
  "integrity": "unsupported",
  "country_code": "FR",
  "region_code": "FR-IDF",
  "city": "Paris",
  "geofence": { "enabled": true, "result": "outside" },
  "inside_geofence": false,
  "geofence_basis": "device",
  "inside_areas": [],
  "blocked_areas": [],
  "position_source": "device_and_ip",
  "anonymizers": { "vpn": false, "proxy": false, "tor": false, "spoofing": null, "emulator": null },
  "ip_distance_km": 0,
  "ip_distance_uncertainty_km": 12.4,
  "ip_consistent": true,
  "document_distance_km": null,
  "travel_excused": null,
  "consecutive_mismatches": 1,
  "attempts": 3,
  "consent": { "accepted_at": "2026-11-03T10:14:55Z", "version": "hosted-web-1", "locale": "en" },
  "warnings": [
    {
      "risk": "LOCATION_OUTSIDE_GEOFENCE",
      "log_type": "error",
      "short_description": "Device location outside the allowed area",
      "node_id": "geolocation_1"
    }
  ]
}
```

| Campo | Tipo | Descripción |
| - | - | - |
| `node_id` | string | El nodo del flujo que produjo el resultado, para que un flujo con dos pasos de ubicación siga siendo legible. |
| `status` | string | `Approved`, `In Review`, `Declined` o `Not Finished`, determinado a partir de las advertencias. |
| `outcome` | string | Lo que ocurrió en el intento aceptado. Consulta los [resultados](https://docs.didit.me/es/core-technology/location-verification/overview.md#resultados). |
| `permission` | string | Lo que concedió el sistema: `granted_precise`, `granted_approximate`, `denied`, `restricted`, `unavailable`, `timeout`, `dismissed` o `not_requested` (paso solo por IP). |
| `latitude`, `longitude` | number o null | Posición WGS84. `null` cuando no hay posición. |
| `accuracy_m` | number o null | Radio de incertidumbre en metros. |
| `accuracy_confidence` | string o null | Nivel de confianza del radio: `p95` (web), `p68` (Android) o `unspecified` (iOS). Cada plataforma es distinta, por lo que se registra en lugar de normalizarse. |
| `measured_at` | datetime o null | Cuándo midió el dispositivo la posición, según el reloj del dispositivo. |
| `age_seconds` | integer o null | Tiempo entre la medición y el momento en que Didit la recibió. |
| `source` | string o null | `gps`, `fused`, `network`, `wifi`, `cell`, `browser`, `unknown` o `ip` en un paso solo por IP. |
| `platform` | string o null | `web`, `ios`, `android`, `react_native` o `flutter`. |
| `sdk_version` | string o null | La versión del SDK que produjo la posición. |
| `is_mock` | boolean o null | El sistema informó de una posición simulada. `null` significa que la plataforma no puede saberlo (web), no `false`. |
| `produced_by_accessory` | boolean o null | Solo iOS: la posición provino de un accesorio externo. |
| `integrity` | string | Atestación del dispositivo: `attested`, `not_attested`, `failed`, `unsupported` (web) o `not_determined`. |
| `country_code`, `region_code`, `city` | string o null | El lugar al que corresponde la posición, calculado sin conexión: ISO 3166-1 alpha-2, ISO 3166-2 y la localidad poblada más cercana. La ciudad es una etiqueta para los revisores, nunca una entrada de reglas. |
| `geofence` | object | `enabled` y `result`: `inside`, `outside` o `undetermined`. `result` es `null` cuando la geovalla está desactivada. |
| `inside_geofence` | boolean o null | `true` o `false`, y `null` cuando la geovalla está desactivada o el círculo de precisión cruza un límite. |
| `geofence_basis` | string o null | Qué posición usó el veredicto del área: `device` o `ip`. |
| `inside_areas`, `blocked_areas` | array | Los `id` de las áreas permitidas que contienen todo el círculo de precisión y de las áreas bloqueadas en las que se encuentra la posición. |
| `position_source` | string o null | El `geolocation_position_source` del nodo cuando se ejecutó el intento. |
| `anonymizers` | object o null | `vpn`, `proxy`, `tor`, `spoofing` y `emulator`, cada uno `true`, `false` o `null` cuando la fuente no puede saberlo. |
| `ip_distance_km` | number o null | Distancia a la ubicación de la IP tras restar ambos radios de incertidumbre. 0 significa que se solapan. |
| `ip_distance_uncertainty_km` | number o null | El radio combinado que se restó. |
| `ip_consistent` | boolean o null | `ip_distance_km` está dentro de `geolocation_ip_distance_km`. `null` cuando se desconoce cualquiera de los dos lados. |
| `document_distance_km` | number o null | Distancia a la dirección geocodificada del documento. `null` cuando no hay ninguna dirección registrada. |
| `travel_excused` | boolean o null | La tolerancia de viaje justificó la distancia. `null` cuando la tolerancia está desactivada. |
| `consecutive_mismatches` | integer o null | En un intento final, esta comprobación más las discrepancias anteriores consecutivas de la misma persona. |
| `attempts` | integer | El número del intento. |
| `consent` | object o null | `accepted_at`, `version` y `locale` del aviso de ubicación que aceptó la persona. |
| `warnings` | array | Las [advertencias](https://docs.didit.me/es/core-technology/location-verification/warnings-location-verification.md) del paso. |

## `geolocation_attempts[]`

Todos los intentos de todos los pasos de ubicación, del más antiguo al más reciente, con los mismos campos de medición, incertidumbre, área y distancia que `geolocation_checks[]` excepto `warnings`, además de:

| Campo | Tipo | Descripción |
| - | - | - |
| `received_at` | datetime | Cuándo recibió Didit el intento. |
| `created_at` | datetime | Cuándo se registró el intento. |

Se omiten los intentos sustituidos por un nuevo envío.
Los datos sin procesar enviados por el cliente y el desafío nunca se devuelven.

## Campos para reglas de estado y ramas

Las `status_rules` personalizadas y las reglas de rama pueden leer estos campos:
`geolocation.status`, `geolocation.outcome`, `geolocation.permission`, `geolocation.latitude`, `geolocation.longitude`, `geolocation.accuracy_m`, `geolocation.accuracy_confidence`, `geolocation.age_seconds`, `geolocation.measured_at`, `geolocation.source`, `geolocation.platform`, `geolocation.country` (ISO 3166-1 alpha-3), `geolocation.region`, `geolocation.city`, `geolocation.is_mock`, `geolocation.integrity`, `geolocation.inside_geofence`, `geolocation.ip_distance_km`, `geolocation.ip_consistent`, `geolocation.document_distance_km`, `geolocation.attempts`, `geolocation.consent_at`, `geolocation.inside_areas`, `geolocation.blocked_areas`, `geolocation.anonymizers` (`vpn`, `proxy`, `tor`, `spoofing`, `emulator`) y `geolocation.consecutive_mismatches`.
Un valor ausente solo coincide con `is_empty`, de modo que una regla escrita para una señal de fraude nunca se activa por datos ausentes.

## Contenido relacionado

* [Verificación de ubicación](https://docs.didit.me/es/core-technology/location-verification/overview.md): cómo funciona el paso y cuánto cuesta.
* [Advertencias de verificación de ubicación](https://docs.didit.me/es/core-technology/location-verification/warnings-location-verification.md): todos los códigos `LOCATION_*`.
* [Webhooks](https://docs.didit.me/es/integration/webhooks.md): `status.updated` incluye las listas.
* [Modelos de datos: objeto Warning](https://docs.didit.me/es/reference/data-models.md#objeto-de-advertencia): la estructura de cada entrada de `warnings[]`.


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