---
updatedAt: 2026-07-07T17:42:21.000Z
agentTools:
  projectIndex: https://docs.bynn.com/llms.txt
---

# Create - Age Verification with Liveness

Age Verification with Liveness ensures the user is physically present in front of the camera by requiring real-time facial movement detection. This method prevents spoofing, deepfakes, and injection attacks by verifying biometric liveness before estimating age. It provides a significantly higher level of security compared to static selfie-based verification, making it the preferred choice for fraud prevention and regulatory compliance.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "BYNN API",
    "description": "The BYNN API is organized around REST. Our API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP authentication and HTTP verbs, which are understood by off-the-shelf HTTP clients. We support cross-origin resource sharing, allowing you to interact securely with our API from a client-side web application (though you should never expose your secret API key in any public website’s client-side code). JSON is returned by all API responses, including errors, although our API libraries convert responses to appropriate language-specific objects. To make the API as explorable as possible, accounts have test mode and live mode API keys. There is no “switch” for changing between modes, just use the appropriate key to perform a live or test transaction. Requests made with test-mode credentials never hit live networks and incur no cost. **AUTHENTICATION:** Please use your **Private API Key** that looks like this `private_Nv7UpwQbSmWtUTiSWfw1bdHm` as the username and password in HTTP basic auth.",
    "termsOfService": "https://bynn.com/terms",
    "contact": {
      "name": "BYNN Development Team",
      "email": "hello@bynn.com",
      "url": "https://docs.bynn.com"
    },
    "license": {
      "name": "BYNN Documentation",
      "url": "https://docs.bynn.com"
    },
    "version": "1.0"
  },
  "tags": [
    {
      "name": "age_verification",
      "description": "Operations about age_verifications"
    }
  ],
  "paths": {
    "/age_verification/liveness": {
      "post": {
        "summary": "Create - Age Verification with Liveness",
        "description": "Age Verification with Liveness ensures the user is physically present in front of the camera by requiring real-time facial movement detection. This method prevents spoofing, deepfakes, and injection attacks by verifying biometric liveness before estimating age. It provides a significantly higher level of security compared to static selfie-based verification, making it the preferred choice for fraud prevention and regulatory compliance.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/postAgeVerificationLiveness"
              }
            }
          },
          "required": true
        },
        "security": [
          {
            "PublicKey": []
          }
        ],
        "responses": {
          "201": {
            "description": "Create - Age Verification with Liveness",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Bynn_V1_Entities_LivenessCreate"
                }
              }
            }
          },
          "400": {
            "description": "Could not start liveness",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Bynn_V1_Entities_Error"
                }
              }
            }
          }
        },
        "tags": [
          "age_verification"
        ],
        "operationId": "postAgeVerificationLiveness"
      }
    }
  },
  "servers": [
    {
      "url": "//api.bynn.com/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "PublicKey": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header",
        "description": "Enter your PUBLIC KEY token prefixed with `Bearer `, e.g. `Bearer your_token_here`"
      }
    },
    "schemas": {
      "Bynn_V1_Entities_Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "example": "validation_error",
                "description": "Type of error"
              },
              "message": {
                "type": "string",
                "example": "Invalid parameters",
                "description": "Error message"
              }
            },
            "required": [
              "type",
              "message"
            ]
          }
        },
        "required": [
          "error"
        ],
        "description": "Bynn_V1_Entities_Error model"
      },
      "postAgeVerificationLiveness": {
        "type": "object",
        "properties": {
          "unique_id": {
            "type": "string",
            "description": "Unique identifier for the user in your system so you can identify the user in a webhook callback. Can be email or uuid"
          }
        },
        "required": [
          "unique_id"
        ],
        "description": "Create - Age Verification with Liveness"
      },
      "Bynn_V1_Entities_LivenessCreate": {
        "type": "object",
        "properties": {
          "session_id": {
            "type": "string",
            "description": "Liveness session identifier"
          }
        },
        "required": [
          "session_id"
        ],
        "description": "Bynn_V1_Entities_LivenessCreate model"
      }
    }
  }
}
```