> ## 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

> An API to download selfie images submitted through FaceAuth, allowing efficient retrieval of images for specific submissions using authId.

## 1. Base URL

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

## 2. Authentication

Include the API key in the x-api-key header:

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

## 3. Request Example

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

## 4. Request Parameters

<ResponseField name="authId" type="string" required>
  The authId to download the image
</ResponseField>

## 5. Response

Returns a base64 encoded image.

### 5-1.Success Response

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

### 5-2. Error Codes

If an error occurs, a 400 status code is returned along with details in the response body:

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

| Error Code                   | Description                                                                                                                       |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `faceAuth_project not found` | This error occurs when there is no valid project corresponding to the submitted API-Key. Please check if your API-Key is correct. |
| `authId is required`         | The authId parameter is missing from the request parameters.                                                                      |