Skip to content

Social Media Screening

A Social Media Screening searches publicly available social media content for material that may be relevant to a candidate's background check. The result includes any flagged behavior categories and a PDF document of the findings.

Operations

Retrieve an existing Social Media Screening

Request

Returns an existing Social Media Screening with the input ID.

Security
basic_auth
Path
idstringrequired

ID of the Social Media Screening to retrieve.

curl -i -X GET \
  -u '<username>:<password>' \
  'https://docs.checkr.com/_mock/apis/openapi/social_media_screenings/{id}'

Responses

Social Media Screening details

Bodyapplication/json
idstring(ResourceId)read-only

ID of the resource.

Example:"e44aa283528e6fde7d542194"
objectstring
Value:"social_media_screenings"
uristring(ResourceURI)read-only

URI of the resource.

Example:"/v1/social_media_screenings/272bc1dc1ee7c355e76b8a3e"
statusstring(ScreeningStatus)

Status of the screening.

Enum:"complete""pending"
Example:"complete"
resultstring or null(ScreeningResult)

Result of the screening.

Enum:"clear""consider"
Example:"consider"
assessmentstring or null(AssessmentAttribute)

The assessment for this screening. This field will be non-null only for Assess-enabled accounts. For accounts with Assess enabled, it will be null for reports completed before Assess was enabled, and null for a short time after report completion while the account's Assess rules are applied.

Enum:"eligible""review""escalated"
Example:"eligible"
created_atstring, (date-time)

Time at which the screening was created.

Example:"2014-01-18T12:34:00Z"
completed_atstring, (date-time)

Time at which the screening was completed.

Example:"2014-01-18T12:35:30Z"
turnaround_timeinteger

Number of seconds the screening took to complete, calculated from created_at to completed_at.

Example:86400
cancellation_reasonstring or null

See cancellation reasons section for possible values.

Example:"complete_now_customer_requested"
cancellation_reason_descriptionstring or null

See cancellation reasons section for possible values.

Example:"Customer requested Complete Now prior to screening completion"
documentobject

PDF document containing the social media screening results. Returned once the screening status is complete.

flagged_behaviorsArray of strings

List of behavior categories flagged during the screening.

Example:
[
  "Disparaging",
  "Drugs/Alcohol"
]
Response
{
  "id": "e44aa283528e6fde7d542194",
  "object": "social_media_screenings",
  "uri": "/v1/social_media_screenings/272bc1dc1ee7c355e76b8a3e",
  "status": "complete",
  "result": "consider",
  "assessment": "eligible",
  "created_at": "2014-01-18T12:34:00Z",
  "completed_at": "2014-01-18T12:35:30Z",
  "turnaround_time": 86400,
  "cancellation_reason": "complete_now_customer_requested",
  "cancellation_reason_description": "Customer requested Complete Now prior to screening completion",
  "document": {
    "id": "e44aa283528e6fde7d542194",
    "type": "social_media_screening_pdf",
    "created_at": "2026-06-08T19:25:23Z",
    "download_uri": "https://checkr-documents.checkr.com/download_path",
    "filesize": 132327,
    "filename": "social_media_data_search.pdf",
    "content_type": "application/pdf",
    "locale": "en",
    "object": "document"
  },
  "flagged_behaviors": [
    "Disparaging",
    "Drugs/Alcohol"
  ]
}
© Checkr, Inc.