Skip to main content
API docs by Redocly

Screening Supplier Platform API (1.0.0)

Download OpenAPI specification:Download

Introduction

This documentation is designed to provide assistance to Access Screening Supplier Platform customers wishing to integrate with our API

The API allows you to submit and retrieve different check results.

Overview

This page sets out a high level overview of the integration that can be created between 3rd party applications & Access Screening Supplier Platform.

Authentication

Generate Token

Request Body schema: application/json
required

The Request Body

grant_type
string
client_id
string <uuid>
client_secret
string

Responses

Request samples

Content type
application/json
{
  • "grant_type": "client_credentials",
  • "client_id": "e800e019-7e7b-4180-beb9-0cb947bf0850",
  • "client_secret": "<Enter Client Secret>"
}

Response samples

Content type
application/json
{
  • "access_token": "<JWT TOKEN>",
  • "token_type": "Bearer",
  • "expires_in": 3600
}

Adverse Financial Detail

Lookup addresses by postcode

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

postCode
required
string <= 10 characters

The postcode to lookup addresses for.

object (metaData)

Responses

Request samples

Content type
application/json
{
  • "postCode": "SE9 3PA",
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "totalResults": "2",
  • "addresses": [
    ]
}

Match Address

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

object (matchAddressRequestAddress)
object (metaData)

Responses

Request samples

Content type
application/json
{
  • "address": {
    },
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "matchStatus": "UniqueMatch",
  • "addresses": [
    ]
}

Create

Authorizations:
bearer_auth
header Parameters
X-Check-Version
string
Enum: "current" "next"

Optional Check Version (Default: current)

Request Body schema: application/json
required

The Request Body

required
object (equifaxCandidate)
required
object (equifaxCandidateAddress)
required
object (metaData)

Responses

Request samples

Content type
application/json
{
  • "candidate": {
    },
  • "currentAddress": {
    },
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "uuid": "00000000-0000-0000-0000-000000000000",
  • "data": {
    }
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The Background Check UUID for the adverse financial detail results

Responses

Response samples

Content type
application/json
{
  • "checkId": 0,
  • "started": "2025-12-09T09:54:56.8752836Z",
  • "completed": "2025-12-09T09:59:56.8752839Z",
  • "status": "Pending",
  • "yourReference": "ABC123",
  • "customerName": "Example Customer",
  • "data": {
    }
}

Adverse Financial Summary

Lookup addresses by postcode

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

postCode
required
string <= 10 characters

The postcode to lookup addresses for.

object (metaData)

Responses

Request samples

Content type
application/json
{
  • "postCode": "SE9 3PA",
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "totalResults": "2",
  • "addresses": [
    ]
}

Match Address

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

object (matchAddressRequestAddress)
object (metaData)

Responses

Request samples

Content type
application/json
{
  • "address": {
    },
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "matchStatus": "UniqueMatch",
  • "addresses": [
    ]
}

Create

Authorizations:
bearer_auth
header Parameters
X-Check-Version
string
Enum: "current" "next"

Optional Check Version (Default: current)

Request Body schema: application/json
required

The Request Body

required
object (equifaxCandidate)
required
object (equifaxCandidateAddress)
required
object (metaData)

Responses

Request samples

Content type
application/json
{
  • "candidate": {
    },
  • "currentAddress": {
    },
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "uuid": "00000000-0000-0000-0000-000000000000",
  • "data": {
    }
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The Background Check UUID for the adverse financial summary check results

Responses

Response samples

Content type
application/json
{
  • "checkId": 0,
  • "started": "2025-12-09T09:54:56.8574009Z",
  • "completed": "2025-12-09T09:59:56.8574012Z",
  • "status": "Pending",
  • "yourReference": "ABC123",
  • "customerName": "Example Customer",
  • "data": {
    }
}

Checks

Get Check Attachments

Authorizations:
bearer_auth
query Parameters
uuid
required
string <uuid>

The UUID of the check.

id
required
integer <int64>

The ID of the attachment.

Responses

Response samples

Content type
application/pdf
stream

DBS Basic England and Wales

Get Document Types

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

countryCode
required
string = 2 characters
route
integer <int32> [ 1 .. 2 ]
excludePassport
boolean
excludeDrivingLicence
boolean

Responses

Request samples

Content type
application/json
{
  • "countryCode": "GB",
  • "route": 1,
  • "excludePassport": false,
  • "excludeDrivingLicence": false
}

Response samples

Content type
application/json
{
  • "numberOfDocumentsRequired": 2,
  • "nextRoute": 2,
  • "documents": {
    }
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The Background Check UUID for the identity check results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

disclosureType
string

The level of disclosure check to perform

required
object (disclosureCandidate)

The candidate on which to perform the check.

Array of objects (disclosureAddress)

The addresses to check against.

object (disclosureBirthDetails)

The required details of the candidate's birth.

object (disclosurePassport)

The optional passport details of the candidate.

object (disclosureDrivingLicence)

The optional driving licence details of the candidate.

Array of objects (disclosureIdentityDocument)

The optional identity document selections of the candidate.

Array of objects (disclosureOtherName)

The other names of the candidate if required.

hasReadPrivacyPolicy
boolean

Indicates that the candidate has read all necessary privacy policies.

hasSeenStatementOfFairProcessing
boolean

Indicates that the candidate has seen the statement of fair processing.

consentToObtainResult
boolean

Indicates that the candidate has consented to obtain the result.

candidateDeclarationHasUnspentConvictions
required
boolean

The candidate's declaration as to whether they have unspent convictions.

paperCertToCandidate
required
boolean

Indicates whether the paper certificate should be sent to the candidate.

object (paperCertificateRecipient)

The details of the paper certificate recipient, if not the candidate.

customerNameOnCert
boolean

Indicates whether the customer name should be printed on the certificate.

idVerifyName
string

The name of the person who has verified the candidate's ID docs.

object (dbsEAndWSectionX)

Indicates the Section X information for this position.

purposeOfCheck
string

The purpose of the check. Default = 'Employment'

object (metaData)

Responses

Request samples

Content type
application/json
{
  • "disclosureType": "DBS E&W",
  • "candidate": {
    },
  • "addresses": [
    ],
  • "birthDetails": {
    },
  • "passport": {
    },
  • "drivingLicence": {
    },
  • "identityDocuments": [
    ],
  • "otherNames": [
    ],
  • "hasReadPrivacyPolicy": true,
  • "hasSeenStatementOfFairProcessing": true,
  • "consentToObtainResult": true,
  • "candidateDeclarationHasUnspentConvictions": false,
  • "paperCertToCandidate": false,
  • "paperCertRecipient": {
    },
  • "customerNameOnCert": true,
  • "idVerifyName": "John Doe",
  • "sectionX": {
    },
  • "purposeOfCheck": "employment",
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

DBS Enhanced

Get Document Types

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

countryCode
required
string = 2 characters
isVolunteer
boolean
route
integer <int32> [ 1 .. 3 ]
excludePassport
boolean
excludeDrivingLicence
boolean

Responses

Request samples

Content type
application/json
{
  • "countryCode": "GB",
  • "isVolunteer": false,
  • "route": 1,
  • "excludePassport": false,
  • "excludeDrivingLicence": false
}

Response samples

Content type
application/json
{
  • "numberOfDocumentsRequired": 2,
  • "nextRoute": 2,
  • "documents": {
    }
}

Get Position Setting

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

positionSettingId
integer or null <int32>
settingName
string

Responses

Request samples

Content type
application/json
{
  • "positionSettingId": 0,
  • "settingName": "Hospital"
}

Response samples

Content type
application/json
{
  • "count": 1,
  • "results": [
    ]
}

Get Postions

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

positionId
integer or null <int32>
positionName
string
levelOfCheck
string
workForceType
string
positionSettingId
integer or null <int32>
inUse
boolean or null

Responses

Request samples

Content type
application/json
{
  • "positionId": 1,
  • "positionName": "Nurse",
  • "levelOfCheck": "ENHANCED",
  • "workForceType": "ADULT",
  • "positionSettingId": 1,
  • "inUse": true
}

Response samples

Content type
application/json
{
  • "count": 1,
  • "results": [
    ]
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The Background Check UUID for the identity check results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

disclosureType
string

The level of disclosure check to perform

required
object (dbsEnhancedCandidate)

The candidate on which to perform the check.

Array of objects (disclosureAddress)

The addresses to check against.

object (disclosureBirthDetails)

The required details of the candidate's birth.

object (disclosurePassport)

The optional passport details of the candidate.

object (disclosureDrivingLicence)

The optional driving licence details of the candidate.

Array of objects (disclosureIdentityDocument)

The optional identity document selections of the candidate.

Array of objects (disclosureOtherName)

The other names of the candidate if required.

hasReadPrivacyPolicy
boolean

Indicates that the candidate has read all necessary privacy policies.

hasSeenStatementOfFairProcessing
boolean

Indicates that the candidate has seen the statement of fair processing.

consentToObtainResult
boolean

Indicates that the candidate has consented to obtain the result.

candidateDeclarationHasUnspentConvictions
required
boolean

The candidate's declaration as to whether they have unspent convictions.

candidateDeclarationHasUnprotectedConvictions
required
boolean

The candidate's declaration as to whether they have unprotected convictions.

paperCertToCandidate
required
boolean

Indicates whether the paper certificate should be sent to the candidate.

object (paperCertificateRecipient)

The details of the paper certificate recipient, if not the candidate.

customerNameOnCert
boolean

Indicates whether the customer name should be printed on the certificate.

idVerifyName
string

The name of the person who has verified the candidate's ID docs.

object (disclosurePositionSectionX)

Indicates the Section X information for this position.

purposeOfCheck
string

The purpose of the check. Default = 'Employment'

currentAddressChecked
required
boolean

Indicates whether the candidate's current address is checked.

dsOrganisationId
integer <int32>

The ID of the DS organisation to perform the check.

object (metaData)

Responses

Request samples

Content type
application/json
{
  • "disclosureType": "DBS Enhanced",
  • "candidate": {
    },
  • "addresses": [
    ],
  • "birthDetails": {
    },
  • "passport": {
    },
  • "drivingLicence": {
    },
  • "identityDocuments": [
    ],
  • "otherNames": [
    ],
  • "hasReadPrivacyPolicy": true,
  • "hasSeenStatementOfFairProcessing": true,
  • "consentToObtainResult": true,
  • "candidateDeclarationHasUnspentConvictions": false,
  • "candidateDeclarationHasUnprotectedConvictions": false,
  • "paperCertToCandidate": false,
  • "paperCertRecipient": {
    },
  • "customerNameOnCert": true,
  • "idVerifyName": "John Doe",
  • "sectionX": {
    },
  • "purposeOfCheck": "employment",
  • "currentAddressChecked": true,
  • "dsOrganisationId": 894,
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

DBS Standard

Get Document Types

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

countryCode
required
string = 2 characters
isVolunteer
boolean
route
integer <int32> [ 1 .. 3 ]
excludePassport
boolean
excludeDrivingLicence
boolean

Responses

Request samples

Content type
application/json
{
  • "countryCode": "GB",
  • "isVolunteer": false,
  • "route": 1,
  • "excludePassport": false,
  • "excludeDrivingLicence": false
}

Response samples

Content type
application/json
{
  • "numberOfDocumentsRequired": 2,
  • "nextRoute": 2,
  • "documents": {
    }
}

Get Position Setting

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

positionSettingId
integer or null <int32>
settingName
string

Responses

Request samples

Content type
application/json
{
  • "positionSettingId": 0,
  • "settingName": "Hospital"
}

Response samples

Content type
application/json
{
  • "count": 1,
  • "results": [
    ]
}

Get Postions

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

positionId
integer or null <int32>
positionName
string
levelOfCheck
string
workForceType
string
positionSettingId
integer or null <int32>
inUse
boolean or null

Responses

Request samples

Content type
application/json
{
  • "positionId": 1,
  • "positionName": "Nurse",
  • "levelOfCheck": "ENHANCED",
  • "workForceType": "ADULT",
  • "positionSettingId": 1,
  • "inUse": true
}

Response samples

Content type
application/json
{
  • "count": 1,
  • "results": [
    ]
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The Background Check UUID for the identity check results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

disclosureType
string

The level of disclosure check to perform

required
object (disclosureCandidate)

The candidate on which to perform the check.

Array of objects (disclosureAddress)

The addresses to check against.

object (disclosureBirthDetails)

The required details of the candidate's birth.

object (disclosurePassport)

The optional passport details of the candidate.

object (disclosureDrivingLicence)

The optional driving licence details of the candidate.

Array of objects (disclosureIdentityDocument)

The optional identity document selections of the candidate.

Array of objects (disclosureOtherName)

The other names of the candidate if required.

hasReadPrivacyPolicy
boolean

Indicates that the candidate has read all necessary privacy policies.

hasSeenStatementOfFairProcessing
boolean

Indicates that the candidate has seen the statement of fair processing.

consentToObtainResult
boolean

Indicates that the candidate has consented to obtain the result.

candidateDeclarationHasUnspentConvictions
required
boolean

The candidate's declaration as to whether they have unspent convictions.

candidateDeclarationHasUnprotectedConvictions
required
boolean

The candidate's declaration as to whether they have unprotected convictions.

paperCertToCandidate
required
boolean

Indicates whether the paper certificate should be sent to the candidate.

object (paperCertificateRecipient)

The details of the paper certificate recipient, if not the candidate.

customerNameOnCert
boolean

Indicates whether the customer name should be printed on the certificate.

idVerifyName
string

The name of the person who has verified the candidate's ID docs.

object (disclosurePositionSectionX)

Indicates the Section X information for this position.

purposeOfCheck
string

The purpose of the check. Default = 'Employment'

currentAddressChecked
required
boolean

Indicates whether the candidate's current address is checked.

dsOrganisationId
integer <int32>

The ID of the DS organisation to perform the check.

object (metaData)

Responses

Request samples

Content type
application/json
{
  • "disclosureType": "DBS Standard",
  • "candidate": {
    },
  • "addresses": [
    ],
  • "birthDetails": {
    },
  • "passport": {
    },
  • "drivingLicence": {
    },
  • "identityDocuments": [
    ],
  • "otherNames": [
    ],
  • "hasReadPrivacyPolicy": true,
  • "hasSeenStatementOfFairProcessing": true,
  • "consentToObtainResult": true,
  • "candidateDeclarationHasUnspentConvictions": false,
  • "candidateDeclarationHasUnprotectedConvictions": false,
  • "paperCertToCandidate": false,
  • "paperCertRecipient": {
    },
  • "customerNameOnCert": true,
  • "idVerifyName": "John Doe",
  • "sectionX": {
    },
  • "purposeOfCheck": "employment",
  • "currentAddressChecked": true,
  • "dsOrganisationId": 894,
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Digital Identity - High

Generate Token

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

background_check_uuid
string or null <uuid>

Responses

Request samples

Content type
application/json
{
  • "background_check_uuid": "70349bc5-2e88-4e8b-9c35-d5e92ea1909d"
}

Response samples

Content type
application/json
{
  • "token": "dummy_token",
  • "expiry": "2025-12-09T11:24:56.3874201Z"
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The Background Check UUID for the digital identity results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create

Authorizations:
bearer_auth
header Parameters
X-Check-Version
string
Enum: "current" "next"

Optional Check Version (Default: current)

Request Body schema: application/json
required

The Request Body

required
object (onfidoCandidate)
required
object (onfidoCandidateAddress)
object (metaData)

Responses

Request samples

Content type
application/json
{
  • "candidate": {
    },
  • "currentAddress": {
    },
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "data": {
    }
}

Digital Identity - Medium

Generate Token

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

background_check_uuid
string or null <uuid>

Responses

Request samples

Content type
application/json
{
  • "background_check_uuid": "70349bc5-2e88-4e8b-9c35-d5e92ea1909d"
}

Response samples

Content type
application/json
{
  • "token": "dummy_token",
  • "expiry": "2025-12-09T11:24:56.3874201Z"
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The Background Check UUID for the digital identity results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create

Authorizations:
bearer_auth
header Parameters
X-Check-Version
string
Enum: "current" "next"

Optional Check Version (Default: current)

Request Body schema: application/json
required

The Request Body

required
object (onfidoCandidate)
object (metaData)

Responses

Request samples

Content type
application/json
{
  • "candidate": {
    },
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "uuid": "3b44e03f-173d-452d-9340-087e803f9d4c",
  • "data": {
    }
}

Directorship

Create

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

required
object (northRowPerson)
required
object (northRowAddress)
required
object (metaData)

Responses

Request samples

Content type
application/json
{
  • "person": {
    },
  • "currentAddress": {
    },
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "uuid": "384f8f6a-9dfc-42a6-a788-36858fff685e",
  • "data": {
    }
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The UUID of the directorship check

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Driving Licence

Create

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

required
object (drivingLicencePerson)

The person getting the DrivingLicence check.

drivingLicenceNumber
string

The person's driving licence number.

object (metaData)

Responses

Request samples

Content type
application/json
{
  • "person": {
    },
  • "drivingLicenceNumber": "DOE99851010JLB94",
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "uuid": "384f8f6a-9dfc-42a6-a788-36858fff685e",
  • "data": {
    }
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The UUID of the driving licence check

Responses

Response samples

Content type
application/json
[
  • {
    }
]

DS Basic Scotland

Get Document Types

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

route
integer <int32>
excludePassport
boolean
excludeDrivingLicence
boolean

Responses

Request samples

Content type
application/json
{
  • "route": 1,
  • "excludePassport": false,
  • "excludeDrivingLicence": false
}

Response samples

Content type
application/json
{
  • "numberOfDocumentsRequired": 2,
  • "nextRoute": 2,
  • "documents": {
    }
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The Background Check UUID for the identity check results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

disclosureType
string

The level of disclosure check to perform

object (dsBasicScotlandCandidate)

The candidate on which to perform the check.

Array of objects (disclosureAddress)

The addresses to check against.

object (disclosureBirthDetails)

The required details of the candidate's birth.

object (disclosurePassport)

The optional passport details of the candidate.

object (disclosureDrivingLicence)

The optional driving licence details of the candidate.

Array of objects (disclosureIdentityDocument)

The optional identity document selections of the candidate.

Array of objects (disclosureOtherName)

The other names of the candidate if required.

hasReadPrivacyPolicy
boolean

Indicates that the candidate has read all necessary privacy policies.

hasSeenStatementOfFairProcessing
boolean

Indicates that the candidate has seen the statement of fair processing.

consentToObtainResult
boolean

Indicates that the candidate has consented to obtain the result.

candidateDeclarationHasUnspentConvictions
required
boolean

The candidate's declaration as to whether they have unspent convictions.

paperCertToCandidate
required
boolean

Indicates whether the paper certificate should be sent to the candidate.

object (paperCertificateRecipient)

The details of the paper certificate recipient, if not the candidate.

customerNameOnCert
boolean

Indicates whether the customer name should be printed on the certificate.

idVerifyName
string

The name of the person who has verified the candidate's ID docs.

object (dsBasicScotlandSectionX)

Indicates the Section X information for this position.

purposeOfCheck
string

The purpose of the check. Default = 'Employment'

dsOrganisationId
integer <int32>

The ID of the DS organisation to perform the check.

object (metaData)

Responses

Request samples

Content type
application/json
{
  • "disclosureType": "DS Basic Scotland",
  • "candidate": {
    },
  • "addresses": [
    ],
  • "birthDetails": {
    },
  • "passport": {
    },
  • "drivingLicence": {
    },
  • "identityDocuments": [
    ],
  • "otherNames": [
    ],
  • "hasReadPrivacyPolicy": true,
  • "hasSeenStatementOfFairProcessing": true,
  • "consentToObtainResult": true,
  • "candidateDeclarationHasUnspentConvictions": false,
  • "paperCertToCandidate": false,
  • "paperCertRecipient": {
    },
  • "customerNameOnCert": true,
  • "idVerifyName": "John Doe",
  • "sectionX": {
    },
  • "purposeOfCheck": "employment",
  • "dsOrganisationId": 894,
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Employment Reference

Create

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

object (employmentReferenceCandidate)
Array of objects (employmentReferenceReference)
object (metaData)

Responses

Request samples

Content type
application/json
{
  • "candidate": {
    },
  • "employmentReferences": [
    ],
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Create

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The Background Check UUID for the identity check results

Responses

Response samples

Content type
application/json
{
  • "references": [
    ]
}

Identity Check

Lookup addresses by postcode

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

postCode
required
string <= 10 characters

The postcode to lookup addresses for.

object (metaData)

Responses

Request samples

Content type
application/json
{
  • "postCode": "SE9 3PA",
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "totalResults": "2",
  • "addresses": [
    ]
}

Match Address

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

object (matchAddressRequestAddress)
object (metaData)

Responses

Request samples

Content type
application/json
{
  • "address": {
    },
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "matchStatus": "UniqueMatch",
  • "addresses": [
    ]
}

Create

Authorizations:
bearer_auth
header Parameters
X-Check-Version
string
Enum: "current" "next"

Optional Check Version (Default: current)

Request Body schema: application/json
required

The Request Body

required
object (equifaxCandidate)
required
object (equifaxCandidateAddress)
required
object (metaData)

Responses

Request samples

Content type
application/json
{
  • "candidate": {
    },
  • "currentAddress": {
    },
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "uuid": "00000000-0000-0000-0000-000000000000",
  • "data": {
    }
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The Background Check UUID for the identity check results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

MRZ Document Scan

Create

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

required
object (mrzDocumentScanCandidate)

The candidate on which to perform the check.

documentContents
required
string <= 27962026 characters

The Documents to be MRZ Scanned

object (metaData)

Responses

Request samples

Content type
application/json
{
  • "candidate": {
    },
  • "documentContents": "ZXhhbXBsZSBjb250ZW50",
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "uuid": "00000000-0000-0000-0000-000000000000",
  • "data": {
    }
}

Results

Authorizations:
bearer_auth
query Parameters
uuid
required
string <uuid>

The Check UUID for the mrz document scan check results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Rapid Employment Verification

Create

Authorizations:
bearer_auth
header Parameters
X-Check-Version
string
Enum: "current" "next"

Optional Check Version (Default: current)

Request Body schema: application/json
required

The Request Body

required
object (konfirCandidate)
required
object (konfirCandidateAddress)
required
Array of objects (konfirEmploymentReference)
Array of objects (konfirAcademicReference)
Array of objects (konfirGapReference)
required
object (konfirMetaData)

Responses

Request samples

Content type
application/json
{
  • "candidate": {
    },
  • "currentAddress": {
    },
  • "employmentReferences": [
    ],
  • "academicReferences": [
    ],
  • "gapReferences": [
    ],
  • "metaData": {}
}

Response samples

Content type
application/json
{
  • "uuid": "5848d75b-84b4-431c-b1d8-12e278c672a3",
  • "data": {
    }
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The Background Check UUID for the rapid employment verification results

Responses

Response samples

Content type
application/json
{
  • "checkId": 1,
  • "created": "2025-12-09T09:54:56.8105505Z",
  • "completed": "2025-12-09T09:54:56.8105508Z",
  • "status": "Completed",
  • "data": {
    }
}

Retry

Retry a failed check

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The Background Check UUID for the check to retry

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "message": "string"
}

Sanctions

Create

Authorizations:
bearer_auth
header Parameters
X-Check-Version
string
Enum: "current" "next"

Optional Check Version (Default: current)

Request Body schema: application/json
required

The Request Body

required
object (northRowPerson)
required
object (northRowAddress)
required
object (metaData)

Responses

Request samples

Content type
application/json
{
  • "candidate": {
    },
  • "currentAddress": {
    },
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "uuid": "00000000-0000-0000-0000-000000000000",
  • "data": {
    }
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The Background Check UUID for the digital identity results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Social Media

Create

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

required
object (socialMediaPerson)
checkType
string
Enum: "Essentials" "Plus"

The type of social media check. Either 'Essentials' or 'Plus'.

object (metaData)

Responses

Request samples

Content type
application/json
{
  • "person": {
    },
  • "checkType": "Essentials",
  • "metaData": {
    }
}

Response samples

Content type
application/json
{
  • "uuid": "384f8f6a-9dfc-42a6-a788-36858fff685e",
  • "data": {
    }
}

Results

Authorizations:
bearer_auth
query Parameters
backgroundCheckUuid
required
string <uuid>

The UUID of the Social Media Check.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Webhooks

Results

Authorizations:
bearer_auth

Responses

Response samples

Content type
application/json
[]

Create

Authorizations:
bearer_auth
Request Body schema: application/json
required

The Request Body

url
required
string
object
enabled
boolean or null
eventTypes
Array of strings

Responses

Request samples

Content type
application/json
{
  • "url": "https://example.com/",
  • "headers": {
    },
  • "enabled": true,
  • "eventTypes": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0
}