NAV Navbar
CURL
  • TOPICS
  • EMAIL VERIFICATION
  • PHONE VERIFICATION
  • ADDRESS VERIFICATION
  • COMBINED API
  • TOPICS

    Xverify's API's

    The following API's vary in which services they support, the quantity of records they can be queried with and how they return results.

    Try them now by registering now.

    Authentication

    Example Email Verification API Request Code

    GET "https://api.xverify.com/v5/ev?email=johndoe@yahoo.com&api_key=1011111-B6DBE13C&domain=yourdomain.com"
    

    Replace 1011111-B6DBE13C with your actual API key and yourdomain.com with the value of the domain you've registered with Xverify.

    To obtain a Xverify API key, first register here.

    To find your API key, click the Implementation tab in the left column. Your key will be in the API IMPLEMENTATION section, and will look like:

    Your API key: 10155098-A9876452D

    Please keep your key safe and secret so it is not abused.

    EMAIL VERIFICATION

    Email Verification - Introduction

    Xverify's specializes in email address verification. We can help you filter out invalid and fraudulent email addresses which results in higher open rates, clicks and conversions.

    Email Verification API Endpoint

    Email Verification Endpoint

    https://api.xverify.com/v2/ev
    

    The endpoint to verify a single email address is in the right column.

    Email Query Parameters

    The query parameters for Email Verification are shown in the table below.

    Parameter Required Description
    email yes The email address to be validated (and optionally corrected). The address should be URL encoded as needed.
    domain yes The domain you have configured in your Xverify settings under which this query should be processed. See below.
    api_key yes Your Xverify API key.
    ip no IP address from which a user submitted an email address. Can be used to detect fraudulent or risky submissions.
    ua no User Agent of the browser that submitted the email address. Can be used to detect fraudlent or risky data. The value must be URL encoded.
    aff no The ID you define to identify the affiliate or source of the email for reporting or potential blocking.
    subaff no The sub-identifier you define for the affiliate or source of the email for reporting or potential blocking.

    Example

    Email Verification Sample Query

    https://api.xverify.com/v2/ev?email=bill,smith%40xverify.com.com&api_key=1011111-B6DBE13C&domain=yourdomain.com
    

    Replace 1011111-B6DBE13C with your API key and yourdomain.com with the name of the domain you've registered with Xverify.

    An Email Verification example query is in the right column.

    Email Response Overview

    {
      "status": "invalid",
      "reason": "invalid_domain",
      "email": "bill.smith@xverify.comm",
      "domain_type": null,
      "role_account": false,
      "correction": "bill.smith@xverify.com",
      "duration": 0.2
    }
    

    The API response for Email Verification requests will be in JSON format as showin in the example in the right column.

    The response will contain the following fields:

    Field Description
    status A string describing the category of the email verification result. See our full List of Values.
    reason A short string that describes the specific reason for the "status" categorization. Refer to Email Verification Reasons for a full list of reaons and their descriptions.
    email Contains the email address you queried with in a standardized format.
    domain_type Indicates the type of the domain including, “disposable”, “freeisp”, etc. Refer to Domain Types for a full list of domains and their descriptions.
    role_account Will have a true value if the email address is identified as the role related email account. A role account is an email address for a business job role or a group of people in a company such as sales, info, support, marketing or customer service (e.g. info@abc.com). Because role accounts are not intended for a single person, commercial emails are usually flagged as spam. For improved deliverability, we recommend only sending transactional emails to role accounts.
    correction If the input address is invalid and has a reason of "invalid_syntax" due to a syntax or spelling error, we may suggest a corrected forms of the address.
    error If there is a problem processing the request, this will contain a string that describes the error. See the list of errors.
    duration A floating point value of the number of seconds the server took to process the request.

    Email Lists of Values

    Email status

    Every validation response will include one of the status values below:

    Status Description
    valid The email address passed all checks and is safe to mail.
    invalid Do not mail. The email does not have proper syntax, the domain is dead or the mailbox doesn't exist.
    accept_all The domain doesn’t support a mailbox level check. Also known as a "catch all" domain. Expect some bounces from these addresses should you choose to mail them.
    risky The email address is valid but it may cause delivery issues (e.g. spamtrap, honeypot or complainer). If you’re having deliverability issues, don’t send email to risky addresses.
    unknown We couldn't get a response in time. The email syntax and domain are usually valid, but we could not confirm the mailbox. Messages to these addresses may see bounces. Repeating the query later may deliver a valid/invalid status.

    Email reasons

    The reason field will always be present in the response and describes the speific reason for the verification status. In the table below is our full list of email verification reasons, which status value it corresponds to and their descriptions.

    Status Reason Description
    valid verified Valid email address.
    invalid invalid_syntax Syntax or spelling error.
    invalid invalid_domain Domain does not exist or does not accept email.
    invalid invalid_mailbox Mailbox doesn't exist.
    accept_all unverifiable Domain is a catch all and does not support validation.
    risky high_risk Address is a spamtrap, a known complainer or is suppressed.
    risky complainer Address has complained about receiving commercial email.
    risky fraud Address was used in a fraudulent transaction, e.g. credit card fraud.
    risky block_affiliate The affiliate submitting data is blocked in your user settings.
    risky block_by_user This address is blocked in your user settings.
    risky block_country The request included an IP address parameter, and the IP is from a country that is blocked in your user settings.
    unknown no_result A conclusive result could not be determined.

    Domain types

    The domain_type field will be not-null if the type of domain has been categorized. The table below shows the full list of domain types and their descriptions.

    Domain_type Description
    disposable Disposable domain.
    biz The domain of a company.
    edu An educational institution.
    freeisp Free ISP (internet service provider).
    gov A government institution.
    org A non-profit organization.
    paidisp Paid ISP.
    wireless Wireless domain. Do not send unsolicited emails.

    Error values

    The error field will be populated if there is an error processing the request. These are string representations of the HTTP error codes below. Possible values are:

    Error Description
    invalid_api_key The api_key provided is invalid.
    inactive_service Your api_key is not enabled for the service you are trying to use. For example, calling the address verification service when you are only setup for email verification.
    missing_param A required parameter is missing from your request.
    limit_exceeded Your API limit is exceeded. Please add funds or contact your account representative.

    HTTP Status Codes

    Xverify uses HTTP response codes to indicate the success or failure of an API request. Codes in the 2## rage indicate success, and any other values indicate an error. If there is an error, the body of the resposne will indicate the type of error. The API may return the following HTTP Status Codes in the table below.

    Code Description
    200 Request OK.
    400 Bad request. A parameter was missing or has an invalid value.
    401 Unauthorized. Either the api_key was missing or invalid, or you are trying to use a service you are not configured for.
    403 Forbidden. Your query limit has been exceeded.
    500 Internal server error. Please contact support.
    502 Bad gateway. The API is not available. Please try again later or contact support.

    PHONE VERIFICATION

    Phone Verification - Introduction

    Xverify will stop bad phone numbers and provide details on working phones.

    Phone Verification API Endpoint

    Phone Verification Endpoint

    https://api.xverify.com/v2/pv
    

    The endpoint to verify a single phone number is in the right column.

    Phone Query Parameters

    The query parameters for Phone Verification are shown in the table below.

    Parameter Required Description
    phone yes The phone number to be verified. The number should be URL encoded as needed.
    domain yes The domain you have configured in your Xverify settings under which this query should be processed. See below.
    api_key yes Your Xverify API key.
    aff no The ID you define to identify the affiliate or source of the phone for reporting or potential blocking.
    subaff no The sub-identifier you define for the affiliate or source of the phone for reporting or potential blocking.

    Example

    Phone Verification Sample Query

    https://api.xverify.com/v2/pv?phone=1.646.742.1771%20x100&api_key=1011111-B6DBE13C&domain=yourdomain.com
    

    Replace 1011111-B6DBE13C with your API key and yourdomain.com with the name of the domain you've registered with Xverify.

    A Phone Verification example query is in the right column.

    Phone Response Overview

    {
      "phone": "6467421771",
      "extension": "100",
      "status": "valid",
      "reason": "verified",
      "phone_type": "Landline",
      "use_type": "Residential",
      "time_zone": "America/New_York",
      "city": "New York",
      "state": "NY",
      "country": "US",
      "latitude": 40.743801,
      "longitude": -73.977699,
      "error": "",
      "duration": 0.0775
    }
    

    The API response for Phone Verification requests will be in JSON format as showin in the example in the right column.

    The response will contain the following fields:

    Field Description
    status A string describing the category of the phone verification result. See our full List of Values.
    reason A short string that describes the specific reason for the "status" categorization. Refer to Phone Verification Reasons for a full list of reaons and their descriptions.
    phone Contains the phone number you queried with in a standardized format, without any extension.
    extension Contains the extension of the phone number you queried with, if there is one.
    phone_type Indicates the type of phone number: "Landline", "Cell" or "VOIP". Refer to Phone Types for a full list of types and their descriptions.
    use_type The principal use of the phone number: "Business", "Residential" or "Soho".
    time_zone The tz database time zone name. See the list of time zones below.
    city The principal city associated with the phone number. The user may not reside there.
    state The principal state or province associated with the phone number. The user may not reside there.
    country The country the phone number is based in: "US" for United Sates or "CA" for Canada.
    latitude A floating point value representing the latitude of the phone number's wire center.
    longitude A floating point value representing the longitude of the phone number's wire center.
    error If there is a problem processing the request, this will contain a string that describes the error. See the list of errors.
    duration A floating point value of the number of seconds the server took to process the request.

    Phone Lists of Values

    Phone status

    Every phone validation response will include one of the status values below:

    Status Description
    valid The phone number is usable.
    invalid Do not call. The phone number is incorrect or blocked.

    Phone reasons

    The reason field will always be present in the response and describes the speific reason for the verification status. In the table below is our full list of phone verification reasons, which status value it corresponds to and their descriptions.

    Status Reason Description
    valid verified The phone is confirmed to exist in 411.
    valid valid The first seven digits of the phone number are a valid combination.
    invalid syntax The phone number does not have the correct number of digits.
    invalid invalid The phone number has an invalid sequence of digits.
    invalid block_tollfree Number is toll free and your user settings block these numbers.
    invalid block_by_user Phone numbers with this type are blocked by your user settings.
    invalid block_affiliate The affiliate submitting data is blocked in your user settings.

    Phone types

    The phone_type field describes the type of phone number.

    Phone_Type Description
    Landline The number is used with a wired phone.
    Cell The number is used with a wireless phone.
    VOIP The number is used with a Voice Over IP phone.

    Use types

    The use_type field describes the how the phone is primarily used.

    Phone_Type Description
    Business The phone is primarily used by a company or organization.
    Residential The phone is primarily used by a residence or home.
    Soho The phone is primarily used by a small office or home office.

    Time zones

    The time_zone field has the name of the time zone that the number is in. This name format is commonly used within programming applications. The full list of time zones used is below.

    Time_Zone Description
    America/Moncton Atlantic time.
    America/New_York Eastern time.
    America/Chicago Central time.
    America/Denver Mountain time.
    America/Los_Angeles Pacific time.
    America/Anchorage Alaska time.
    Pacific/Honolulu Hawaii time.
    Pacific/Pago_Pago Samoa time.
    Pacific/Majuro Marshall Island Time.
    Pacific/Guam Guam Time.
    Pacific/Palau Palau Time.

    Error values

    The error field will be populated if there is an error processing the request. These are string representations of the HTTP error codes below. Possible values are:

    Error Description
    invalid_api_key The api_key provided is invalid.
    inactive_service Your api_key is not enabled for the service you are trying to use. For example, calling the address verification service when you are only setup for email verification.
    missing_param A required parameter is missing from your request.
    limit_exceeded Your API limit is exceeded. Please add funds or contact your account representative.

    HTTP Status Codes

    Xverify uses HTTP response codes to indicate the success or failure of an API request. Codes in the 2## rage indicate success, and any other values indicate an error. If there is an error, the body of the resposne will indicate the type of error. The API may return the following HTTP Status Codes in the table below.

    Code Description
    200 Request OK.
    400 Bad request. A parameter was missing or has an invalid value.
    401 Unauthorized. Either the api_key was missing or invalid, or you are trying to use a service you are not configured for.
    403 Forbidden. Your query limit has been exceeded.
    500 Internal server error. Please contact support.
    502 Bad gateway. The API is not available. Please try again later or contact support.

    ADDRESS VERIFICATION

    Address Verification - Introduction

    Xverify's postal address verification API identifies invalid postal addresses, standardizes valid addresses and corrects data errors in addresses. The API supports addresses from the United States and Canada.

    Address Verification API Endpoint

    Email Verification Endpoint

    https://api.xverify.com/v2/av
    

    The endpoint to verify a single postal address is in the right column.

    Address Query Parameters

    The query parameters for Address Verification are shown in the table below.

    Parameter Required Description
    address1 yes The street address to be verified. The address should be URL encoded as needed.
    address2 no The second line of the street address to be verified.
    city no The city of the address to be verified. Required if zip is not provided.
    state no The state of the address to be verified. Required if zip is not provided.
    zip no The postal code of the address to be verified. Required if city and state are not provided.
    urbanization no A component of certain addresses in Puerto Rico.
    parse no Set to a value of true if you want the street address to be parsed into individual elements in the response.
    domain yes The domain you have configured in your Xverify settings under which this query should be processed. See below.
    api_key yes Your Xverify API key.
    aff no The ID you define to identify the affiliate or source of the email for reporting or potential blocking.
    subaff no The sub-identifier you define for the affiliate or source of the email for reporting or potential blocking.

    Example

    Address Verification Sample Query

    https://api.xverify.com/v2/ev?address1=33%20Irving%20Place&city=New%20York&state=NY&zip=10003&parse=true&api_key=1011111-B6DBE13C&domain=yourdomain.com
    

    Replace 1011111-B6DBE13C with your API key and yourdomain.com with the name of the domain you've registered with Xverify.

    An Address Verification example query is in the right column.

    Address Response Overview

    {
      "status": "possibly_valid",
      "reason": "maildrop_or_inactive",
      "address1": "33 Irving Pl Fl 3",
      "city": "New York",
      "state": "NY",
      "zip": "10003",
      "plus4": "2332",
      "corrected": true,
      "carrier_route": "C046",
      "delivery_point": "033",
      "address_type": "Highrise",
      "zip_type": "Standard",
      "flags": [],
      "parsed_street": {
        "primary_number": "33",
        "street_name": "Irving",
        "street_suffix": "Pl",
        "secondary_name": "Fl"
        "secondary_number": "3",
      },
      "country": "US",
      "duration": "1.6894"
    }
    

    The API response for Address Verification requests will be in JSON as shown in the example in the right column.

    The response will contain the following fields:

    Field Description
    status A string describing the category of the address verification result. See our full List of Values.
    reason A short string that describes the specific reason for the "status" categorization. Refer to Address Verification Reasons for a full list of reaons and their descriptions.
    corrected Indicates if there was a material correction to the address, such as changing the street name, city or zip - true or false. In interactive use, you may want to confirm the corrected values with the user.
    address1 The standardized street address.
    city The standardized city name.
    state The two-letter abbreviation for the U.S. state or Canadian province.
    zip The U.S. five-digit zip code or the Canadian six-digit postal code for the address.
    plus4 The four-digit portion of a U.S. Zip+4.
    urbanization For certain addresses in Puerto Rico, this field will be returned with the name of the area the street is located in. See how to use it.
    country The two-character country abbreviation - "US" for United States or "CA" for Canada.
    carrier_route The four-character carrier route of a U.S. address.
    delivery_point A three-digit number that is the two-digit delivery point code combined with the delivery point check digit. You can construct a complete POSTNet barcode number by concatenating the zip, plus4 and delivery_point fields.
    address_type The type of the address. See the list of address types.
    zip_type For U.S. addresses, the type of zip code. See the list of zip types.
    error If there is a problem processing the request, this will contain a string that describes the error. See the list of errors.
    duration A floating point value of the number of seconds the server took to process the request.

    Address Lists of Values

    Address status

    Every postal address verification response will include one of the status values below:

    Status Description
    valid The postal address is deliverable.
    probably_valid There are characteristics about the address that may cause delivery issues, but it is mostly likely deliverable.
    possibly_valid There are multiple or more serious factors that could cause delivery to the address to fail, but the address is still valid.
    invalid The address is not deliverable by the U.S.P.S.

    Address Reasons

    The reason field will always be present in the response and describes the primary reason for the verification status. In the table below is our full list of address verification reasons, which status value it corresponds to and their descriptions.

    Status Reason Description
    valid deliverable Input is or was converted to a valid postal address.
    probably_valid missing_secondary Address is DPV confirmed for the primary address only, and secondary number information, such as suite or apartment number, was missing.
    probably_valid invalid_secondary Address is DPV confirmed for the primary address only, and secondary number information, such as suite or apartment number, was present but unconfirmed.
    probably_valid usps_only Address is DPV confirmed for an address that can only be serviced by the USPS, such as a P.O. Box or military address.
    probably_valid pbsa Address is a DPV confirmed P.O. Box Street-Style Address.
    probably_valid cmra Address is a DPV confirmed Commercial Mail Receiving Agency, such as a Mail Boxes, Etc. These addresses have higher turnover, and it is less likely for mail to be returned if the addressee no longer uses the CMRA.
    probably_valid vacant Address is DPV confirmed, but is currently vacant (in most cases, unoccupied over 90 days) and not receiving delivery. Future mail may be received.
    possibly_valid missing_secondary Address is DPV confirmed for the primary address only, and secondary number information, such as suite or apartment number, was missing. See the “flags” field for additional reasons the address may not be deliverable.
    possibly_valid invalid_secondary Address is DPV confirmed for the primary address only, and secondary number information, such as suite or apartment number, was present but unconfirmed. See the “flags” field for additional reasons the address may not be deliverable.
    possibly_valid maildrop_or_inactive Address is DPV confirmed but does not receive direct delivery because a) customer receives mail as a part of a drop; b) delivery has not been established; or c) the address is no longer a possible delivery because the carrier destroys or returns all of the mail. Some buildings, such as Xverify’s New York office, and multi-tenant residences receive mail as a drop. Therefore the post office does not have statistics on final delivery to the addressee, and it is less likely for mail to be returned if the addressee is no longer there.
    possibly_valid unique_zip The zip code is assigned to a large organization or agency, and mail to that zip is routed by that organization. For unique zips, no validation is done on the street, city or state and it is very easy for bogus information to be entered. For example, 12345 is a unique zip and an address of NOT HERE, HEY, NY 12345 would be accepted.
    possibly_valid military_zip Address is DPV confirmed for a military zip code. Final delivery to the addressee will done by the military installation, and it is less likely for mail to be returned if the addressee no longer resides there.
    possibly_valid general_delivery General Delivery is a mail service for those without a permanent address, often used as a temporary mailing address. Mail is held for the recipient for at most 30 days.
    possibly_valid missing_pmb Address is for a CMRA (see above) but the Private Mail Box (PMB) number is missing, which makes delivery less likely.
    possibly_valid not_accessible Address is DPV confirmed, but the USPS has flagged it as a place where carriers cannot physically access a building or door for mail delivery. Mail may not be delivered.
    invalid invalid_zip The address could not be verified at the postal code level.
    invalid invalid_street The street name could not be matched.
    invalid invalid_location This address is not deliverable.
    invalid invalid_data Minimum requirements for the address to be verified are not met. Check the content and formatting of the address.
    invalid invalid_primary The house or building number for the address is not valid.
    invalid missing_primary The house or building number is missing.
    invalid invalid_box The PO (Post Office Box), RR (Rural Route), or HC (Highway Contract) Box number is invalid.
    invalid missing_box The PO (Post Office Box), RR (Rural Route), or HC (Highway Contract) Box number is missing.
    invalid multiple_match The address was matched to multiple records and there was not enough information to find a unique match.
    invalid ews_match This address currently cannot be verified but was identified by the Early Warning System (EWS) as belonging to a upcoming area and may be deliverable in the future.
    invalid invalid_country The address is for a country not-supported by this service.
    invalid non_usps This US address is not serviced by the USPS, and a Plus4 could not be assigned, but it is possible that it may receive mail through third party carriers like UPS.
    unknown no_result A conclusive result could not be determined.

    Address flags

    The flags field is an array that may be populated with additional information about the address that may affect delivery. If a flag is a primary concern, it will appear in the reason field.

    flag Description
    cmra Address is a DPV confirmed Commercial Mail Receiving Agency, such as a Mail Boxes, Etc. These addresses have higher turnover, and it is less likely for mail to be returned if the addressee no longer uses the CMRA.
    pbsa The address is P.O. Box using a Street-Style Address.
    lacs_update The address has been converted by LACSLink® from a rural-style address to a city-style address.
    maildrop_or_inactive Address does not receive direct delivery because a) customer receives mail as a part of a drop; b) delivery has not been established; or c) the address is no longer a possible delivery because the carrier destroys or returns all of the mail. Some buildings, such as Xverify’s New York office, and multi-tenant residences receive mail as a drop. Therefore the post office does not have statistics on final delivery to the addressee, and it is less likely for mail to be returned if the addressee is no longer there.
    usps_only The address can only be serviced by the USPS, such as a P.O. Box or military address.
    vacant Address is currently vacant (in most cases, unoccupied over 90 days) and not receiving delivery. Future mail may be received.
    extra_text Extraneous information not used in verifying the address was found. This includes unnecessary sub premises and other unrecognized data. If you use the “parsed=true” parameter, this additional information will either be placed into the secondary or extra_text output fields.

    Address types

    The address_type field will be populated if the type of address has been categorized. The table below shows the full list of address types.

    address_type values for U.S. addresses:

    address_type values for Canadian addresses:

    Zip types

    The zip_type field will be populated if the input is a U.S. address, and the type of zip code has been categorized. Possible values are:

    Error values

    The error field will be populated if there is an error processing the request. These are string representations of the HTTP error codes below. Possible values are:

    Error Description
    invalid_api_key The api_key provided is invalid.
    inactive_service Your api_key is not enabled for the service you are trying to use. For example, calling the address verification service when you are only setup for email verification.
    missing_param A required parameter is missing from your request.
    limit_exceeded Your API limit is exceeded. Please add funds or contact your account representative.

    HTTP Status Codes

    Xverify uses HTTP response codes to indicate the success or failure of an API request. Codes in the 2## rage indicate success, and any other values indicate an error. If there is an error, the body of the resposne will indicate the type of error. The API may return the following HTTP Status Codes in the table below.

    Code Description
    200 Request OK.
    400 Bad request. A parameter was missing or has an invalid value.
    401 Unauthorized. Either the api_key was missing or invalid, or you are trying to use a service you are not configured for.
    403 Forbidden. Your query limit has been exceeded.
    500 Internal server error. Please contact support.
    502 Bad gateway. The API is not available. Please try again later or contact support.

    COMBINED API

    Combined API Call - Introduction

    Xverify's can verify an email address, phone number and a postal address in a single API call.

    Combined API Endpoint

    Combined API Endpoint

    https://api.xverify.com/v2/aio
    

    The endpoint to verify an email address, phone number and a postal address together is in the right column.

    Combined Query Parameters

    The combined API endpoint accepts both Email Verification query parameters, Phone Verification query parameters and Address Verification query parameters. Please see the documentation of those respective APIs.

    The combined endpoint can be used to validate just an email address, just a phone number or just a postal address as well. Just use the parameters of the data you are trying to verify.

    Combined API Example

    Combined API Sample Query

    https://api.xverify.com/v2/aio?email=info@xverify.com&phone=6467421771&address1=350%20N%20Orleans%20st&address2=suite%209000N&city=chicago&state=il&zip=60654&api_key=1011111-B6DBE13C&domain=yourdomain.com
    

    Replace 1011111-B6DBE13C with your API key and yourdomain.com with the name of the domain you've registered with Xverify.

    A combined verification example query is in the right column.

    Combined Response Overview

    {
      "email": {
        "email": "info@xverify.com",
        "status": "valid",
        "reason": "verified",
        "domain_type": "",
        "correction": "",
        "message": "Email is verified",
        "role_account": true
      },
      "phone": {
        "phone": "6467421771",
        "extension": "",
        "status": "valid",
        "reason": "verified",
        "phone_type": "Landline",
        "use_type": "Residential",
        "time_zone": "America/New_York",
        "city": "New York",
        "state": "NY",
        "country": "US",
        "latitude": 40.743801,
        "longitude": -73.977699,
        "error": "",
        "duration": 0.0775
      },
      "address": {
        "address1": "350 N Orleans St Ste 9000N",
        "city": "Chicago",
        "state": "IL",
        "zip": "60654",
        "plus4": "1701",
        "status": "valid",
        "reason": "deliverable",
        "carrier_route": "C002",
        "delivery_point": "244",
        "address_type": "Highrise",
        "zip_type": "Standard",
        "corrected": false,
        "flags": [],
        "country": "US"
      }
    }
    

    The API response for combined email + phone + postal requests will be in JSON as shown in the example in the right column.

    The response will contain an "email" section, if an email address was included in the query. The contents of this section will be the same as the email verification response.

    The response will contain a "phone" section, if a phone number was included in the query. The contents of this section will be the same as the phone verification response.

    The response will contain an "address" section, if a postal address was included in the query. The contents of this section will be the same as the address verification response.