Education Verification

Use an Education Verification to verify a candidate’s education history, and highest degree achieved.

For this screening, candidates are asked to supply their degree, major, school, and the state in which the school is located. Checkr then attempts to verify the information. After three failed attempts (itemized in the logs), Checkr generates an exception, and asks the candidate to upload supporting documentation. Once the document is uploaded, the verification process will begin again.

For more information, please see Education Verification in the Checkr Help Center.

Operations

Retrieve an existing Education Verification

Request

Returns an existing Education Verification with the input ID.

Security

basic_auth

Path

idstringrequired

ID of the Education Verification to retrieve.

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

Responses

Education Verification details

Bodyapplication/json

idstring(ResourceId)read-only

ID of the resource.

Example:"e44aa283528e6fde7d542194"

objectstring

Value:"education_verification"

uristring(ResourceURI)read-only

URI of the resource.

Example:"/v1/education_verifications/595511af261066005170f47"

statusstring(ScreeningStatus)

Status of the screening.

Enum:"complete""pending"

Example:"consider"

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:603216

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"

includes_canceledboolean or null(IncludesCanceledBoolean)

If account has opted in to report lifecycle phase two, indicates the presence of canceled histories. Otherwise, null.

Enum:truefalse

Example:true

recordsArray of objects

Array of CandidateEducationHistory records.

Response

{
  "id": "e44aa283528e6fde7d542194",
  "object": "education_verification",
  "uri": "/v1/education_verifications/595511af261066005170f47",
  "status": "consider",
  "result": "consider",
  "assessment": "eligible",
  "created_at": "2014-01-18T12:34:00Z",
  "completed_at": "2014-01-18T12:35:30Z",
  "turnaround_time": 603216,
  "cancellation_reason": "complete_now_customer_requested",
  "cancellation_reason_description": "Customer requested Complete Now prior to screening completion",
  "includes_canceled": true,
  "records": [
    { … }
  ]
}