Skip to main content
POST
/
api
/
v2
/
email-social
Email Social Insight
curl --request POST \
  --url https://{environment-subdomain}.idmetagroup.com/api/v2/email-social \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "email_address": "<string>",
  "template_id": "{your_trust_flow_id}",
  "verification_id": "{your_created_verification_id}"
}
'
{
  "status": "VERIFIED",
  "message": "OK",
  "result": {
    "code": "OK",
    "message": "Success!",
    "requestId": "23bbcd80-e007-46c2-af41-3e2dfd5eb52e",
    "data": {
      "id": "fp-e4fe40826a12412eb4e8a847e8e5840f",
      "createdAt": "2026-04-23T02:00:35Z",
      "status": "COMPLETED",
      "resultCode": "SUCCESS",
      "resultMessage": null,
      "requestMeta": {
        "templateId": "tpl-ftp005001",
        "emailAddress": "farahsaffiah08@gmail.com",
        "countryCode": "PH",
        "footprintItemsTimeout": null,
        "consent": {
          "type": "IDmeta Phone Number & Email Footprint Consent",
          "version": "v1",
          "consentedAt": "2026-04-23T09:00:35Z",
          "consentedWith": "By Starting",
          "consentTemplateId": "ct-e09587eec0b548668e38bdf1a729952d"
        }
      },
      "items": [
        {
          "name": "registered",
          "value": "true",
          "valueType": "BOOLEAN"
        },
        {
          "name": "creationTime",
          "value": "1995-08-13 00:00:00",
          "valueType": "STRING"
        },
        {
          "name": "registrarName",
          "value": "MarkMonitor; Inc.",
          "valueType": "STRING"
        },
        {
          "name": "companyName",
          "value": null,
          "valueType": "STRING"
        },
        {
          "name": "isFreeWebmail",
          "value": "true",
          "valueType": "BOOLEAN"
        },
        {
          "name": "deliverable",
          "value": "true",
          "valueType": "BOOLEAN"
        },
        {
          "name": "disposable",
          "value": "false",
          "valueType": "BOOLEAN"
        },
        {
          "name": "tenure",
          "value": "7.39",
          "valueType": "NUMBER"
        },
        {
          "name": "breached",
          "value": "true",
          "valueType": "BOOLEAN"
        },
        {
          "name": "breachCount",
          "value": "2",
          "valueType": "NUMBER"
        },
        {
          "name": "firstBreachDate",
          "value": "2018-12-01",
          "valueType": "STRING"
        },
        {
          "name": "lastBreachDate",
          "value": "2020-06-29",
          "valueType": "STRING"
        }
      ]
    }
  },
  "risk_rating": "LOW"
}

Authorizations

Authorization
string
header
required

Use Bearer {your_api_token} in the Authorization header.

Headers

Accept
string
default:application/json
Content-Type
string
default:application/json

Body

application/json
email
string<email>
required

Email address to be analyzed for social insights.

template_id
string
required

Identifier used to categorize or group requests for tracking or reporting.

verification_id
string
required

A unique ID used to identify your verification request.

email_address
string

Alternate email address for analysis when applicable.

Response

200 - application/json

Email social insight completed successfully

status
message
string
result
object
risk_rating
string