Workday Recruiting · JSON Structure

Recruiting Rest Api Background Check Structure

Background check results for a candidate, provided by an external screening provider.

Type: object Properties: 7
HCMHuman ResourcesRecruitingSaaSTalent Acquisition

BackgroundCheck is a JSON Structure definition published by Workday Recruiting, describing 7 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

id candidate jobApplication package status result completedOn

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑ 
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/workday-recruiting/refs/heads/main/json-structure/recruiting-rest-api-background-check-structure.json",
  "name": "BackgroundCheck",
  "description": "Background check results for a candidate, provided by an external screening provider.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Workday ID (WID) of the background check",
      "example": "11111111-2222-3333-4444-555555555555"
    },
    "candidate": {
      "type": "object",
      "description": "A reference to a related Workday resource",
      "properties": {
        "id": {
          "type": "string",
          "description": "Workday ID (WID) of the referenced resource",
          "example": "11111111-2222-3333-4444-555555555555"
        },
        "descriptor": {
          "type": "string",
          "description": "Display name of the referenced resource",
          "example": "Senior Software Engineer"
        }
      }
    },
    "jobApplication": {
      "type": "object",
      "description": "A reference to a related Workday resource",
      "properties": {
        "id": {
          "type": "string",
          "description": "Workday ID (WID) of the referenced resource",
          "example": "11111111-2222-3333-4444-555555555555"
        },
        "descriptor": {
          "type": "string",
          "description": "Display name of the referenced resource",
          "example": "Senior Software Engineer"
        }
      }
    },
    "package": {
      "type": "object",
      "description": "A reference to a related Workday resource",
      "properties": {
        "id": {
          "type": "string",
          "description": "Workday ID (WID) of the referenced resource",
          "example": "11111111-2222-3333-4444-555555555555"
        },
        "descriptor": {
          "type": "string",
          "description": "Display name of the referenced resource",
          "example": "Senior Software Engineer"
        }
      }
    },
    "status": {
      "type": "string",
      "enum": [
        "Initiated",
        "In Progress",
        "Completed",
        "Canceled"
      ],
      "description": "Current status of the background check",
      "example": "Initiated"
    },
    "result": {
      "type": "string",
      "enum": [
        "Clear",
        "Consider",
        "Adverse Action"
      ],
      "description": "Background check result",
      "example": "Clear"
    },
    "completedOn": {
      "type": "datetime",
      "description": "Timestamp when the check was completed",
      "example": "2026-05-03T14:30:00Z"
    }
  }
}