Phone ID - Identity attributes: Age Verify

📘

NOTE:

To add this feature to your account, contact a Telesign expert. This feature is available for full-service accounts only.

Use this identity attribute to test whether or not the subscriber of a phone number meets a certain age threshold. This could be used, for example, to determine whether a user is old enough to use one of your services.

If the age of the subscriber is equal to or greater than the threshold age, the service returns true. By default the service uses the minimum legal age for the country associated with the phone number as the threshold.

❗️

WARNING

Before you begin using this identity attribute, confirm with our Customer Support Team which countries you expect to be performing checks for. We then must configure your account accordingly before you can successfully make live checks. For some countries you may be able to pass your own custom age threshold, but check with the Customer Support Team before using this feature. Not all countries are supported. If you pass a custom threshold for a country that is not supported, you may get incorrect results.

Examples

Request

POST /v1/phoneid/15555551212 HTTP/1.1
Content-Type: application/json
Authorization: Basic 12345678-9ABC-DEF0-1234-56789ABCDEF0:vjE/ZDfPvDkuGNsuqCFFO4neYIs=
Host: rest-ww.telesign.com
{
  "addons": {
    "age_verify": {
    }
  }
}

Response 1: Meets threshold

See lines 41-47.

HTTP/1.1 200 OK
Content-Type: application/json
{
  "status": {
    "updated_on": "2022-03-24T22:11:20.208521Z",
    "code": 300,
    "description": "Transaction successfully completed"
  },
  "phone_type": {
    "code": "2",
    "description": "MOBILE"
  },
  "numbering": {
    "original": {
      "phone_number": "7537151551",
      "complete_phone_number": "447537151551",
      "country_code": "44"
    },
    "cleansing": {
      "sms": {
        "phone_number": "7537151551",
        "min_length": 10,
        "cleansed_code": 100,
        "max_length": 10,
        "country_code": "44"
      },
      "call": {
        "phone_number": "7537151551",
        "min_length": 10,
        "cleansed_code": 100,
        "max_length": 10,
        "country_code": "44"
      }
    }
  },
  "blocklisting": {
    "block_code": 0,
    "block_description": "Not blocked",
    "blocked": false
  },
  "age_verify": {
    "status": {
      "code": 2800,
      "description": "Request successfully completed"
    },
    "age_verified": true
  },
  "carrier": {
    "name": "Stour Marine Limited"
  },
  "reference_id": "0123456789ABCDEF0123456789ABCDEF",
  "external_id": null,
  "location": {
    "city": "Countrywide",
    "zip": null,
    "country": {
      "iso3": "GBR",
      "iso2": "GB",
      "name": "United Kingdom"
    },
    "time_zone": {
      "utc_offset_min": "0",
      "name": null,
      "utc_offset_max": "0"
    },
    "coordinates": {
      "latitude": null,
      "longitude": null
    },
    "metro_code": null,
    "county": null,
    "state": null
  }
}

Response 2: Does not meet threshold

See lines 41-47.

HTTP/1.1 200 OK
Content-Type: application/json
{
  "status": {
    "updated_on": "2022-03-24T22:11:20.208521Z",
    "code": 300,
    "description": "Transaction successfully completed"
  },
  "phone_type": {
    "code": "3",
    "description": "PREPAID"
  },
  "numbering": {
    "original": {
      "phone_number": "7537151551",
      "complete_phone_number": "447537151551",
      "country_code": "44"
    },
    "cleansing": {
      "sms": {
        "phone_number": "7537151551",
        "min_length": 10,
        "cleansed_code": 100,
        "max_length": 10,
        "country_code": "44"
      },
      "call": {
        "phone_number": "7537151551",
        "min_length": 10,
        "cleansed_code": 100,
        "max_length": 10,
        "country_code": "44"
      }
    }
  },
  "blocklisting": {
    "block_code": 0,
    "block_description": "Not blocked",
    "blocked": false
  },
  "age_verify": {
    "status": {
      "code": 2800,
      "description": "Request successfully completed"
    },
    "age_verified": false
  },
  "carrier": {
    "name": "Stour Marine Limited"
  },
  "reference_id": "0123456789ABCDEF0123456789ABCDEF",
  "external_id": null,
  "location": {
    "city": "Countrywide",
    "zip": null,
    "country": {
      "iso3": "GBR",
      "iso2": "GB",
      "name": "United Kingdom"
    },
    "time_zone": {
      "utc_offset_min": "0",
      "name": null,
      "utc_offset_max": "0"
    },
    "coordinates": {
      "latitude": null,
      "longitude": null
    },
    "metro_code": null,
    "county": null,
    "state": null
  }
}

Response 3: Failure

See lines 41-46.

HTTP/1.1 200 OK
Content-Type: application/json
{
  "status": {
    "updated_on": "2022-03-24T22:11:20.208521Z",
    "code": 301,
    "description": "Transaction partially completed"
  },
  "phone_type": {
    "code": "3",
    "description": "PREPAID"
  },
  "numbering": {
    "original": {
      "phone_number": "7537151551",
      "complete_phone_number": "447537151551",
      "country_code": "44"
    },
    "cleansing": {
      "sms": {
        "phone_number": "7537151551",
        "min_length": 10,
        "cleansed_code": 100,
        "max_length": 10,
        "country_code": "44"
      },
      "call": {
        "phone_number": "7537151551",
        "min_length": 10,
        "cleansed_code": 100,
        "max_length": 10,
        "country_code": "44"
      }
    }
  },
  "blocklisting": {
    "block_code": 0,
    "block_description": "Not blocked",
    "blocked": false
  },
  "age_verify": {
    "status": {
      "code": 2803,
      "description": "Phone number out of Age Verify identity attribute coverage."
    }
  },
  "carrier": {
    "name": "Stour Marine Limited"
  },
  "reference_id": "0123456789ABCDEF0123456789ABCDEF",
  "external_id": null,
  "location": {
    "city": "Countrywide",
    "zip": null,
    "country": {
      "iso3": "GBR",
      "iso2": "GB",
      "name": "United Kingdom"
    },
    "time_zone": {
      "utc_offset_min": "0",
      "name": null,
      "utc_offset_max": "0"
    },
    "coordinates": {
      "latitude": null,
      "longitude": null
    },
    "metro_code": null,
    "county": null,
    "state": null
  }
}