> ## 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/Faceauth/Image

> Una API para descargar imágenes selfie enviadas a través de FaceAuth, permitiendo la obtención eficiente de imágenes para envíos específicos usando authId.

## 1. URL base

```text GET/FaceAuth/Image theme={null}
  https://rest-api.argosidentity.com/v3/faceauth/image
```

## 2. Autenticación

Incluya la clave API en el encabezado x-api-key:

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

## 3. Ejemplo de solicitud

```curl GET/FaceAuth theme={null}
  curl --location "https://rest-api.argosidentity.com/v3/faceauth/image?authId={yourAuthId}" \
  --header 'x-api-key: {yourAPIKey}'
```

## 4. Parámetros de solicitud

<ResponseField name="authId" type="string" required>
  El authId para descargar la imagen
</ResponseField>

## 5. Respuesta

Devuelve una imagen codificada en base64.

### 5-1. Respuesta exitosa

```json example.png theme={null}
  /9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BST0ZJTEUAAQEAAAHIAAAAAAQwAABtbnRyUkdCIFhZ...
```

### 5-2. Códigos de error

Si ocurre un error, se devuelve un código de estado 400 junto con detalles en el cuerpo de la respuesta:

```json error.json theme={null}
{
  traceId: '0199cb93-bdf1-77ef-8cd4-3d38dec61830',
  errorCode: 'NOT_FOUND',
  message: 'faceAuth_project not found'
}
```

| Código de error              | Descripción                                                                                                                      |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `faceAuth_project not found` | Este error ocurre cuando no existe un proyecto válido correspondiente a la API-Key enviada. Verifique si su API-Key es correcta. |
| `authId is required`         | El parámetro authId falta en los parámetros de la solicitud.                                                                     |
