Submit request to generate social media screening report for a set of PII

Use this endpoint to submit Personally Identifiable Information (PII) for social media background screening reports. This API is usually used in conjunction with the "SAFETY_FETCH.*" webhooks, read more in the Documentation.

POST /v1/safety/profile-screening

Basic auth

curl 'https://api.staging.insightiq.ai/v1/safety/profile-screening' \
  --request POST \
  --header 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  --header 'Content-Type: application/json' \
  --data '{
  "first_name": "example",
  "middle_name": "example",
  "last_name": "example",
  "flagging_criteria_id": "123e4567-e89b-42d3-a456-426614174000",
  "date_of_birth": "2026-01-01",
  "social_media_profiles": [
    {
      "work_platform_id": "123e4567-e89b-42d3-a456-426614174000",
      "profile_url": [
        "https://example.com/profile"
      ]
    }
  ],
  "emails": [
    "[email protected]"
  ],
  "contact_numbers": [
    "example"
  ],
  "addresses": [
    {
      "city": "example",
      "state": "example",
      "country": "example",
      "start_date": "2026-01-01",
      "end_date": "2026-01-01",
      "line1": "example",
      "line2": "example",
      "line3": "example",
      "": "example"
    }
  ],
  "work_experiences": [
    {
      "job_title": "example",
      "employer_name": "example",
      "start_date": "2026-01-01",
      "end_date": "2026-01-01"
    }
  ],
  "education": [
    {
      "degree": "example",
      "institution_name": "example",
      "start_date": "2026-01-01",
      "end_date": "2026-01-01"
    }
  ],
  "aliases": [
    "example"
  ],
  "profile_image_url": "http://example.com"
}'

{
  "id": "123e4567-e89b-42d3-a456-426614174000",
  "status": "IN_PROGRESS"
}

Accepted

Body

· ProfileScreeningRequest

application/json

first_name string required

middle_name string

last_name string required

flagging_criteria_id string · uuid

Flagging criteria ID (if no flagging ID is passed, default criteria will be used for flagging)

date_of_birth string · date

Date of birth in YYYY-MM-DD format

social_media_profiles array of object

emails array of string required

contact_numbers array of string

Body

Responses