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

# Consultar verificación

> Consulta el seguimiento y resultado de una verificación por folio.

Consulta el seguimiento y resultado de una verificación domiciliaria o laboral por folio.

## Catálogos de respuesta

### VerificationStatus

Indica en qué etapa va el trámite:

| Valor                 | Significado                                         |
| --------------------- | --------------------------------------------------- |
| `NoIniciado`          | Creada, la liga aún no sale.                        |
| `Enviado`             | La liga se entregó al solicitante.                  |
| `Abierto`             | El solicitante abrió la liga.                       |
| `Iniciado`            | Aceptó el consentimiento y va avanzando.            |
| `Completado`          | Terminó todo el flujo.                              |
| `Expirado`            | Se venció sin completarse.                          |
| `Rechazado`           | Cancelada.                                          |
| `SuspendidaPorRiesgo` | Se detectaron señales de manipulación de ubicación. |

### Verdict

Resolución del analista: `Pendiente`, `Aprobada`, `Rechazada`, `Reposicion` (se le pide al solicitante repetir la captura).

### GeoResult

Ubicación real contra domicilio declarado:

| Valor           | Significado                              |
| --------------- | ---------------------------------------- |
| `Consistente`   | ≤ 100 m                                  |
| `Inconsistente` | > 500 m                                  |
| `Indeterminado` | Sin precisión suficiente o sin domicilio |

### GeoIntegrity

Plausibilidad del rastreo: `Ok`, `Sospechosa`, `Comprometida`. Cuando no es `Ok`, `GeoSignals` trae el detalle (p. ej. `["VelocidadImposible:834km/h"]`).

### BiometricStatus

`Iniciada`, `Completada`, `Pendiente` (el proveedor aún no emite veredicto), `Aprobada`, `Rechazada`.

## Ejemplo de respuesta 200

```json theme={null}
{
  "Code": 200,
  "Status": "Success",
  "Message": "Seguimiento obtenido",
  "Data": {
    "Folio": "VD-2607-ZUZFKY",
    "ExternalReference": "EXP-2026-00123",
    "VerificationStatus": "Completado",
    "Verdict": "Aprobada",
    "VerdictComment": null,
    "Modality": "Domiciliar",
    "ProductName": "Crédito Autoplazo",
    "ProductKey": "AUTOPLAZO",
    "CreatedAtUtc": "2026-07-28T23:37:42Z",
    "SentAtUtc": "2026-07-28T23:38:10Z",
    "CompletedAtUtc": "2026-07-28T23:55:02Z",
    "ExpiresAtUtc": "2026-08-04T23:37:42Z",
    "GeoResult": "Consistente",
    "DistanceMeters": 42.7,
    "Accuracy": 12.5,
    "GeoIntegrity": "Ok",
    "GeoSignals": null,
    "BiometricStatus": "Aprobada",
    "Photos": [
      {
        "Section": "1.1 Fachada",
        "Url": "https://storage.example.com/foto.jpg",
        "TimestampUtc": "2026-07-28T23:50:11Z",
        "GeoResult": "Consistente",
        "DistanceMeters": 38.2,
        "HashSha256": "9f2b…"
      }
    ]
  }
}
```

<Note>
  `ApplicantUrl` **no** se devuelve en esta consulta. Solo viaja en la respuesta de [crear verificación](/api-reference/kyb/crear-verificacion).
</Note>

## Errores

| HTTP | Status      | Message                                                                  |
| ---- | ----------- | ------------------------------------------------------------------------ |
| 403  | `forbidden` | `El ID de Workspace no es válido o no está activo`                       |
| 404  | `not_found` | `Verificación no encontrada` — el folio no existe o es de otro workspace |


## OpenAPI

````yaml GET /verificaciones/{folio}
openapi: 3.0.0
info:
  title: KYB API
  version: 1.0.0
servers:
  - url: https://nufi.azure-api.net/kyb
    description: Productivo
  - url: https://nufi.azure-api.net/kyb/dev
    description: Sandbox
  - url: https://nufi-kyb-services-staging-azurefunction.azurewebsites.net/api
    description: Staging
security: []
paths:
  /verificaciones/{folio}:
    get:
      tags:
        - verificaciones
      summary: consultar verificación
      description: Consulta el seguimiento y resultado de una verificación por folio.
      operationId: getVerification
      parameters:
        - name: folio
          in: path
          required: true
          schema:
            type: string
          description: Folio de la verificación (p. ej. VD-2607-ZUZFKY).
          example: VD-2607-ZUZFKY
        - name: NUFI-API-KEY
          in: header
          required: true
          schema:
            type: string
          example: '{{NUFI_API_KEY}}'
        - name: X-Workspace
          in: header
          required: true
          schema:
            type: string
          example: '{{WORKSPACE_ID}}'
      responses:
        '200':
          description: Seguimiento obtenido
          content:
            application/json:
              schema:
                type: object
                properties:
                  Code:
                    type: integer
                    example: 200
                  Status:
                    type: string
                    example: Success
                  Message:
                    type: string
                    example: Seguimiento obtenido
                  Data:
                    type: object
                    properties:
                      Folio:
                        type: string
                        example: VD-2607-ZUZFKY
                      ExternalReference:
                        type: string
                        example: EXP-2026-00123
                      VerificationStatus:
                        type: string
                        description: >-
                          NoIniciado, Enviado, Abierto, Iniciado, Completado,
                          Expirado, Rechazado, SuspendidaPorRiesgo
                        example: Completado
                      Verdict:
                        type: string
                        description: Pendiente, Aprobada, Rechazada,Reposicion
                        example: Aprobada
                      VerdictComment:
                        type: string
                        nullable: true
                      Modality:
                        type: string
                        example: Domiciliar
                      ProductName:
                        type: string
                        example: Crédito Autoplazo
                      ProductKey:
                        type: string
                        example: AUTOPLAZO
                      CreatedAtUtc:
                        type: string
                        format: date-time
                      SentAtUtc:
                        type: string
                        format: date-time
                      CompletedAtUtc:
                        type: string
                        format: date-time
                      ExpiresAtUtc:
                        type: string
                        format: date-time
                      GeoResult:
                        type: string
                        description: Consistente, Inconsistente, Indeterminado
                        example: Consistente
                      DistanceMeters:
                        type: number
                        example: 42.7
                      Accuracy:
                        type: number
                        example: 12.5
                      GeoIntegrity:
                        type: string
                        description: Ok, Sospechosa, Comprometida
                        example: Ok
                      GeoSignals:
                        type: array
                        items:
                          type: string
                        nullable: true
                      BiometricStatus:
                        type: string
                        description: Iniciada, Completada, Pendiente, Aprobada, Rechazada
                        example: Aprobada
                      Photos:
                        type: array
                        items:
                          type: object
                          properties:
                            Section:
                              type: string
                              example: 1.1 Fachada
                            Url:
                              type: string
                              format: uri
                            TimestampUtc:
                              type: string
                              format: date-time
                            GeoResult:
                              type: string
                            DistanceMeters:
                              type: number
                            HashSha256:
                              type: string
              examples:
                success:
                  value:
                    Code: 200
                    Status: Success
                    Message: Seguimiento obtenido
                    Data:
                      Folio: VD-2607-ZUZFKY
                      ExternalReference: EXP-2026-00123
                      VerificationStatus: Completado
                      Verdict: Aprobada
                      VerdictComment: null
                      Modality: Domiciliar
                      ProductName: Crédito Autoplazo
                      ProductKey: AUTOPLAZO
                      CreatedAtUtc: '2026-07-28T23:37:42.000Z'
                      SentAtUtc: '2026-07-28T23:38:10.000Z'
                      CompletedAtUtc: '2026-07-28T23:55:02.000Z'
                      ExpiresAtUtc: '2026-08-04T23:37:42.000Z'
                      GeoResult: Consistente
                      DistanceMeters: 42.7
                      Accuracy: 12.5
                      GeoIntegrity: Ok
                      GeoSignals: null
                      BiometricStatus: Aprobada
                      Photos:
                        - Section: 1.1 Fachada
                          Url: https://storage.example.com/foto.jpg
                          TimestampUtc: '2026-07-28T23:50:11.000Z'
                          GeoResult: Consistente
                          DistanceMeters: 38.2
                          HashSha256: 9f2b…
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  Code:
                    type: integer
                    example: 403
                  Status:
                    type: string
                    example: forbidden
                  Message:
                    type: string
                  Data:
                    nullable: true
              examples:
                forbidden:
                  value:
                    Code: 403
                    Status: forbidden
                    Message: El ID de Workspace no es válido o no está activo
                    Data: null
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  Code:
                    type: integer
                    example: 404
                  Status:
                    type: string
                    example: not_found
                  Message:
                    type: string
                  Data:
                    nullable: true
              examples:
                notFound:
                  value:
                    Code: 404
                    Status: not_found
                    Message: Verificación no encontrada
                    Data: null

````