# Selfie Age Estimation

## AgeMatch 5.0 Estimate API

The AgeMatch 5.0 Estimate API provides an estimate of the age based on a provided selfie.

### POST /process/comprehensive/gateway

Submits a request to estimate the age of a person based on a selfie image.

#### Request

| Field     | Type   | Description                            | Required |
| --------- | ------ | -------------------------------------- | -------- |
| user      | string | Your Veratad username                  | Yes      |
| pass      | string | Your Veratad password                  | Yes      |
| service   | string | The service identifier                 | Yes      |
| reference | string | A unique reference for the transaction | No       |
| rules     | string | Additional rules for the transaction   | No       |
| target    | object | The target information                 | Yes      |

**Target Object**

| Field  | Type   | Description               | Required |
| ------ | ------ | ------------------------- | -------- |
| selfie | string | Base64 encoded face image | Yes      |
| age    | string | The age to check against  | Yes      |

**Example Request**

```json
{
  "user": "username",
  "pass": "password",
  "service": "AgeMatch5.0.Estimate",
  "reference": "12345",
  "rules": "",
  "target": {
    "selfie": "base 64 encoded face image",
    "age": "21+"
  }
}
```

#### Response

The response will contain metadata about the request, output details, and the result of the age estimation.

**Response Object**

| Field  | Type   | Description                                  |
| ------ | ------ | -------------------------------------------- |
| meta   | object | Contains metadata related to the transaction |
| output | object | Contains the output of the age estimate      |
| result | object | Contains the result of the age verification  |

**Meta Object**

| Field        | Type   | Description                         |
| ------------ | ------ | ----------------------------------- |
| confirmation | number | Confirmation number for the request |
| timestamp    | string | Timestamp of the transaction        |
| reference    | string | Reference of the original request   |
| user         | string | Your Veratad username               |
| company      | string | Your company name                   |
| service      | string | The service identifier              |

**Selfie Object**

| Field         | Type   | Description         |
| ------------- | ------ | ------------------- |
| age\_estimate | string | Estimated age range |

**Result Object**

| Field  | Type   | Description                           |
| ------ | ------ | ------------------------------------- |
| action | string | The action taken, either PASS or FAIL |
| detail | string | Details of the action                 |
| issues | array  | An array of issues if any             |

**Example Response**

```json
{
  "meta": {
    "confirmation": 160567642,
    "timestamp": "2023-11-07 13:23:55",
    "reference": "12345",
    "user": "root@veratad.com",
    "company": "Veratad Technologies, LLC",
    "service": "AgeMatch5.0.Estimate.ROC"
  },
  "output": {
    "images": {
      "selfie": {
        "age_estimate": "27-31"
      }
    }
  },
  "result": {
    "action": "PASS",
    "detail": "ALL CHECKS PASSED",
    "issues": []
  }
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api.veratad.com/agematch/selfie-age-estimation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
