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

# GET/Face-auth/{authId}

> API que consulta un único envío de FaceAuth por su authId. Está disponible inmediatamente después de la creación.

<Warning>
  **La consulta individual es ahora un endpoint distinto del de la consulta de lista.**

  Lo que antes era `GET /v3/faceauth?authId=...` es ahora `GET /v3/face-auth/{authId}`, con `authId` como **parámetro de ruta**. Para migrar una integración existente, consulte [Referencia común de FaceAuth — Migrar desde la API anterior](/es/idcheck/add-on/faceauth-reference#migrar-desde-la-api-anterior).
</Warning>

Consulta un único envío de FaceAuth. Puede recuperarse por `authId` inmediatamente después de crearlo, sin esperar a la indexación.

## 1. URL base

```text GET/Face-auth/{authId} theme={null}
GET https://rest-api.argosidentity.com/v3/face-auth/{authId}
```

## 2. Autenticación

Incluya la clave API del proyecto FaceAuth en el encabezado `x-api-key`.

```text x-api-key theme={null}
x-api-key: {yourAPIKey}
```

## 3. Ejemplo de solicitud

```bash GET/Face-auth/{authId} theme={null}
curl -X GET "https://rest-api.argosidentity.com/v3/face-auth/{authId}" \
  -H "x-api-key: {yourAPIKey}"
```

## 4. Parámetros de ruta

<ResponseField name="authId" type="string" required>
  Clave del envío de FaceAuth. Use el `authId` de la [respuesta de creación de POST](/es/idcheck/add-on/post-faceauth) o de la [respuesta de lista](/es/idcheck/add-on/get-faceauth).
</ResponseField>

## 5. Respuesta

```json result.json theme={null}
{
  "authId": "sampleAuthId1",
  "authStatus": "approved",
  "createTime": "2026-08-11T10:09:14.028Z",
  "submitType": "form",
  "kycSubmissionId": "sampleKycSubmissionId1",
  "deleteTime": null,
  "policy": {
    "faceSimilarity": { "enabled": true, "threshold": 85 },
    "occluded": { "enabled": false, "threshold": null },
    "faceCover": { "enabled": false, "threshold": null },
    "headCover": { "enabled": false, "threshold": null },
    "liveness": { "enabled": false, "threshold": null },
    "activeLiveness": { "enabled": true, "threshold": 75 }
  },
  "result": {
    "faceSimilarity": 100,
    "livenessScore": null,
    "activeLivenessScore": 90.60411071777344,
    "occluded": null,
    "faceCover": null,
    "headCover": null
  },
  "signals": {
    "startButtonClickTime": "2026-08-11T10:08:54.742Z",
    "cameraProcessInfo": [
      {
        "processStartTime": "2026-08-11T10:08:57.300Z",
        "processEndTime": "2026-08-11T10:09:12.278Z",
        "type": "faceAuth-passive",
        "error": null
      }
    ]
  },
  "rejectComment": null,
  "failCode": null
}
```

### 5-1. Éxito

Una consulta individual correcta devuelve `200 OK` con un [objeto FaceAuthSubmission](/es/idcheck/add-on/faceauth-reference#objeto-faceauthsubmission). El objeto aparece tal cual en el nivel superior.

<Note>
  * Un elemento de `items[]` de la consulta de lista y la respuesta de la consulta individual son **el mismo objeto**. Consultar el mismo `authId` por cualquiera de las dos rutas devuelve el mismo conjunto de campos.
  * Los envíos eliminados se devuelven con valor en `deleteTime`.
</Note>

### 5-2. Fallo

Una consulta individual fallida devuelve un código de estado HTTP con un [objeto de error](/es/idcheck/add-on/faceauth-reference#respuestas-de-error).

<Warning>
  **Un envío que pertenece a otro proyecto FaceAuth devuelve `404`, igual que un `authId` inexistente.** La respuesta no permite distinguir ambos casos.
</Warning>

## 6. Respuestas de error

Los errores que devuelve la aplicación de ARGOS usan el formato `{ code, message }`. El `401` y algunos `403` se bloquean en la capa de autenticación y no siguen ese formato: consulte [Referencia común de FaceAuth — Respuestas de error](/es/idcheck/add-on/faceauth-reference#respuestas-de-error).

| Estado HTTP | code                            | Condición                                                                                                                       |
| ----------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | `REQUEST_INVALID`               | El parámetro de ruta `authId` no es válido                                                                                      |
| `403`       | `AUTH_FORBIDDEN`                | La clave API es válida pero no está vinculada a un proyecto FaceAuth                                                            |
| `404`       | `FACEAUTH_SUBMISSION_NOT_FOUND` | No se encuentra el `authId` en este proyecto                                                                                    |
| `503`       | `UPSTREAM_UNAVAILABLE`          | Un servicio interno necesario para la consulta no está disponible temporalmente. Reintente la misma solicitud en unos instantes |
| `503`       | `UPSTREAM_INVALID_RESPONSE`     | El resultado interno de la consulta no puede convertirse al contrato público                                                    |
| `500`       | `INTERNAL_UNEXPECTED`           | Error inesperado del servidor                                                                                                   |