Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Workday Recruiting Background Checks API

Submit and retrieve background check results and manage background check packages for candidate screening.

Workday Recruiting Background Checks API is one of 13 APIs that Workday Recruiting publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 56 JSON Schema definitions.

Tagged areas include Background Checks. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, rate-limit docs, a JSON-LD context, and 56 JSON Schemas.

This API exposes 3 operations across 2 paths, and defines 5 schemas. It is described by OpenAPI 3.1.0, at version v41.2.

Requests are made against a single base URL, https://{tenant}.workday.com/ccx/api/recruiting/v41.2.

3 operations 2 paths 5 schemas 2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v41.2
Base URL
https://wd2-impl-services1.workday.com/ccx/api/recruiting/
Authentication
OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 1

Workday Recruiting Background Checks API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 2 scopes. By default, every request must be authenticated.

  • oauth2 — OAuth 2.0 authentication. Register an API client in Workday, grant recruiting scopes, and obtain access tokens.

Paths & Operations 3

Across 2 paths, the API surfaces 3 operations — 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Background Checks 3

Submit and retrieve background check results and manage background check packages for candidate screening.

GET
/backgroundChecks
Workday Recruiting List Background Checks
listBackgroundChecks 3 params → 200401
POST
/backgroundChecks
Workday Recruiting Submit a Background Check Result
submitBackgroundCheck body → 201400401
GET
/backgroundCheckPackages
Workday Recruiting List Background Check Packages
listBackgroundCheckPackages 2 params → 200401

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are BackgroundCheck (7 properties), BackgroundCheckCreate (5 properties), BackgroundCheckPackage (5 properties), Error (3 properties). Each schema is shown below with its type and property counts.

Error
object
API error response
3 properties
BackgroundCheck
object
Background check results for a candidate, provided by an external screening provider.
7 properties
BackgroundCheckPackage
object
A background check package defines a set of screening checks to perform on candidates during the hiring process.
5 properties
Reference
object
A reference to a related Workday resource
2 properties
BackgroundCheckCreate
object
Request body for submitting background check results
5 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

workday-recruiting-background-checks-api-openapi.yml Raw ↑

Other APIs Workday Recruiting publishes across the network.

Workday Recruiting SOAP Web Services API
Workday Recruiting agentDefinition API
Workday Recruiting Applicants API
Workday Recruiting Candidates API
Workday Recruiting Configuration API
Workday Recruiting Evergreen Requisitions API
Workday Recruiting Interviews API
Workday Recruiting Job Applications API
Workday Recruiting Job Postings API
Workday Recruiting Job Requisitions API
Workday Recruiting Positions API
Workday Recruiting Recruiting Agencies API