POST api/BackgroundCheck

Create a new background check

Request Information

URI Parameters

None.

Body Parameters

NCSIBackgroundCheck
NameDescriptionTypeAdditional information
RegistrationNumber

Registration Number / SelfRegCode

integer

Required

Range: inclusive between 10000000 and 99999999

TiebackReferenceNumber

Reference Number that NCSI will use to tie the screen back to an external system

string

Max length: 150

LegalFirstName

Registrant First Name

string

Required

Max length: 35

LegalMiddleName

Registrant Middle Name or Initial

string

Max length: 35

LegalLastName

Registrant Last Name

string

Required

Max length: 35

LegalPostName

Registrant Post Name / Suffix - See available options

PostNameOptions

None.

LegalNameSince

Currently legal name since this date

date

Required

AlternateNames

Alternate Names

Collection of NCSIName

None.

Gender

Gender

GenderOptions

Required

Ssn

Social Security Number

string

Max length: 9

Dob

Date of Birth

date

Required

Email

Registrant Email address

string

Required

Matching regular expression pattern: ^.+\@.+\..+$

Max length: 250

Min length: 6

Phone

Registrant phone number

string

Required

Max length: 14

AddressList

List of registrant addresses

Collection of NCSIAddress

Required

LicenseState

Driver License State

string

Max length: 2

LicenseNumber

Driver License Number (Required if State is populated)

string

Max length: 25

Disclosures

Affirmative disclosure details

Collection of NCSIDisclosure

None.

Reference1

Reference1

string

Max length: 150

Reference2

Reference2

string

Max length: 1024

Reference3

Reference3

string

Max length: 1024

Reference4

Reference4

string

Max length: 1024

Request Formats

application/json, text/json

Sample:
{
  "RegistrationNumber": 1,
  "TiebackReferenceNumber": "sample string 1",
  "LegalFirstName": "sample string 2",
  "LegalMiddleName": "sample string 3",
  "LegalLastName": "sample string 4",
  "LegalPostName": 0,
  "LegalNameSince": "2025-12-06T00:14:35.35503-05:00",
  "AlternateNames": [
    {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "PostName": 0,
      "FromDate": "2025-12-06T00:14:35.35503-05:00",
      "ToDate": "2025-12-06T00:14:35.35503-05:00"
    },
    {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "PostName": 0,
      "FromDate": "2025-12-06T00:14:35.35503-05:00",
      "ToDate": "2025-12-06T00:14:35.35503-05:00"
    }
  ],
  "Gender": 0,
  "Ssn": "sample string 6",
  "Dob": "2025-12-06T00:14:35.35503-05:00",
  "Email": "sample string 8",
  "Phone": "sample string 9",
  "AddressList": [
    {
      "AddressType": 0,
      "CountryCode": "sample string 1",
      "StreetNumber": "sample string 2",
      "StreetName": "sample string 3",
      "Address2": "sample string 4",
      "City": "sample string 5",
      "State": "sample string 6",
      "PostalCode": "sample string 7",
      "FromDate": "2025-12-06T00:14:35.35503-05:00",
      "ToDate": "2025-12-06T00:14:35.35503-05:00",
      "CountyFipsCode": 8,
      "CountyName": "sample string 9"
    },
    {
      "AddressType": 0,
      "CountryCode": "sample string 1",
      "StreetNumber": "sample string 2",
      "StreetName": "sample string 3",
      "Address2": "sample string 4",
      "City": "sample string 5",
      "State": "sample string 6",
      "PostalCode": "sample string 7",
      "FromDate": "2025-12-06T00:14:35.35503-05:00",
      "ToDate": "2025-12-06T00:14:35.35503-05:00",
      "CountyFipsCode": 8,
      "CountyName": "sample string 9"
    }
  ],
  "LicenseState": "sample string 10",
  "LicenseNumber": "sample string 11",
  "Disclosures": [
    {
      "CriteriaQuestion": "sample string 1",
      "CriteriaId": 1,
      "Answer": "sample string 2",
      "CountryCode": "sample string 3",
      "City": "sample string 4",
      "State": "sample string 5",
      "CountyFipsCode": 6,
      "OffenseDate": "2025-12-06T00:14:35.35503-05:00",
      "CourtName": "sample string 8",
      "CourtType": 0,
      "ChargeLevel": 0,
      "ChargeDescription": 0,
      "ChargeDetails": "sample string 9"
    },
    {
      "CriteriaQuestion": "sample string 1",
      "CriteriaId": 1,
      "Answer": "sample string 2",
      "CountryCode": "sample string 3",
      "City": "sample string 4",
      "State": "sample string 5",
      "CountyFipsCode": 6,
      "OffenseDate": "2025-12-06T00:14:35.35503-05:00",
      "CourtName": "sample string 8",
      "CourtType": 0,
      "ChargeLevel": 0,
      "ChargeDescription": 0,
      "ChargeDetails": "sample string 9"
    }
  ],
  "Reference1": "sample string 12",
  "Reference2": "sample string 13",
  "Reference3": "sample string 14",
  "Reference4": "sample string 15"
}

application/xml, text/xml

Sample:
<NCSIBackgroundCheck xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/NCSI.API.ViewModels">
  <AddressList>
    <NCSIAddress>
      <Address2>sample string 4</Address2>
      <AddressType>Current</AddressType>
      <City>sample string 5</City>
      <CountryCode>sample string 1</CountryCode>
      <CountyFipsCode>8</CountyFipsCode>
      <CountyName>sample string 9</CountyName>
      <FromDate>2025-12-06T00:14:35.35503-05:00</FromDate>
      <PostalCode>sample string 7</PostalCode>
      <State>sample string 6</State>
      <StreetName>sample string 3</StreetName>
      <StreetNumber>sample string 2</StreetNumber>
      <ToDate>2025-12-06T00:14:35.35503-05:00</ToDate>
    </NCSIAddress>
    <NCSIAddress>
      <Address2>sample string 4</Address2>
      <AddressType>Current</AddressType>
      <City>sample string 5</City>
      <CountryCode>sample string 1</CountryCode>
      <CountyFipsCode>8</CountyFipsCode>
      <CountyName>sample string 9</CountyName>
      <FromDate>2025-12-06T00:14:35.35503-05:00</FromDate>
      <PostalCode>sample string 7</PostalCode>
      <State>sample string 6</State>
      <StreetName>sample string 3</StreetName>
      <StreetNumber>sample string 2</StreetNumber>
      <ToDate>2025-12-06T00:14:35.35503-05:00</ToDate>
    </NCSIAddress>
  </AddressList>
  <AlternateNames>
    <NCSIName>
      <FirstName>sample string 1</FirstName>
      <FromDate>2025-12-06T00:14:35.35503-05:00</FromDate>
      <LastName>sample string 3</LastName>
      <MiddleName>sample string 2</MiddleName>
      <PostName>None</PostName>
      <ToDate>2025-12-06T00:14:35.35503-05:00</ToDate>
    </NCSIName>
    <NCSIName>
      <FirstName>sample string 1</FirstName>
      <FromDate>2025-12-06T00:14:35.35503-05:00</FromDate>
      <LastName>sample string 3</LastName>
      <MiddleName>sample string 2</MiddleName>
      <PostName>None</PostName>
      <ToDate>2025-12-06T00:14:35.35503-05:00</ToDate>
    </NCSIName>
  </AlternateNames>
  <Disclosures>
    <NCSIDisclosure>
      <Answer>sample string 2</Answer>
      <ChargeDescription>None</ChargeDescription>
      <ChargeDetails>sample string 9</ChargeDetails>
      <ChargeLevel>Felony</ChargeLevel>
      <City>sample string 4</City>
      <CountryCode>sample string 3</CountryCode>
      <CountyFipsCode>6</CountyFipsCode>
      <CourtName>sample string 8</CourtName>
      <CourtType>County</CourtType>
      <CriteriaId>1</CriteriaId>
      <CriteriaQuestion>sample string 1</CriteriaQuestion>
      <OffenseDate>2025-12-06T00:14:35.35503-05:00</OffenseDate>
      <State>sample string 5</State>
    </NCSIDisclosure>
    <NCSIDisclosure>
      <Answer>sample string 2</Answer>
      <ChargeDescription>None</ChargeDescription>
      <ChargeDetails>sample string 9</ChargeDetails>
      <ChargeLevel>Felony</ChargeLevel>
      <City>sample string 4</City>
      <CountryCode>sample string 3</CountryCode>
      <CountyFipsCode>6</CountyFipsCode>
      <CourtName>sample string 8</CourtName>
      <CourtType>County</CourtType>
      <CriteriaId>1</CriteriaId>
      <CriteriaQuestion>sample string 1</CriteriaQuestion>
      <OffenseDate>2025-12-06T00:14:35.35503-05:00</OffenseDate>
      <State>sample string 5</State>
    </NCSIDisclosure>
  </Disclosures>
  <Dob>2025-12-06T00:14:35.35503-05:00</Dob>
  <Email>sample string 8</Email>
  <Gender>Female</Gender>
  <LegalFirstName>sample string 2</LegalFirstName>
  <LegalLastName>sample string 4</LegalLastName>
  <LegalMiddleName>sample string 3</LegalMiddleName>
  <LegalNameSince>2025-12-06T00:14:35.35503-05:00</LegalNameSince>
  <LegalPostName>None</LegalPostName>
  <LicenseNumber>sample string 11</LicenseNumber>
  <LicenseState>sample string 10</LicenseState>
  <Phone>sample string 9</Phone>
  <Reference1>sample string 12</Reference1>
  <Reference2>sample string 13</Reference2>
  <Reference3>sample string 14</Reference3>
  <Reference4>sample string 15</Reference4>
  <RegistrationNumber>1</RegistrationNumber>
  <Ssn>sample string 6</Ssn>
  <TiebackReferenceNumber>sample string 1</TiebackReferenceNumber>
</NCSIBackgroundCheck>

multipart/form-data

Sample:
<NCSIBackgroundCheck xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/NCSI.API.ViewModels"><AddressList><NCSIAddress><Address2>sample string 4</Address2><AddressType>Current</AddressType><City>sample string 5</City><CountryCode>sample string 1</CountryCode><CountyFipsCode>8</CountyFipsCode><CountyName>sample string 9</CountyName><FromDate>2025-12-06T00:14:35.35503-05:00</FromDate><PostalCode>sample string 7</PostalCode><State>sample string 6</State><StreetName>sample string 3</StreetName><StreetNumber>sample string 2</StreetNumber><ToDate>2025-12-06T00:14:35.35503-05:00</ToDate></NCSIAddress><NCSIAddress><Address2>sample string 4</Address2><AddressType>Current</AddressType><City>sample string 5</City><CountryCode>sample string 1</CountryCode><CountyFipsCode>8</CountyFipsCode><CountyName>sample string 9</CountyName><FromDate>2025-12-06T00:14:35.35503-05:00</FromDate><PostalCode>sample string 7</PostalCode><State>sample string 6</State><StreetName>sample string 3</StreetName><StreetNumber>sample string 2</StreetNumber><ToDate>2025-12-06T00:14:35.35503-05:00</ToDate></NCSIAddress></AddressList><AlternateNames><NCSIName><FirstName>sample string 1</FirstName><FromDate>2025-12-06T00:14:35.35503-05:00</FromDate><LastName>sample string 3</LastName><MiddleName>sample string 2</MiddleName><PostName>None</PostName><ToDate>2025-12-06T00:14:35.35503-05:00</ToDate></NCSIName><NCSIName><FirstName>sample string 1</FirstName><FromDate>2025-12-06T00:14:35.35503-05:00</FromDate><LastName>sample string 3</LastName><MiddleName>sample string 2</MiddleName><PostName>None</PostName><ToDate>2025-12-06T00:14:35.35503-05:00</ToDate></NCSIName></AlternateNames><Disclosures><NCSIDisclosure><Answer>sample string 2</Answer><ChargeDescription>None</ChargeDescription><ChargeDetails>sample string 9</ChargeDetails><ChargeLevel>Felony</ChargeLevel><City>sample string 4</City><CountryCode>sample string 3</CountryCode><CountyFipsCode>6</CountyFipsCode><CourtName>sample string 8</CourtName><CourtType>County</CourtType><CriteriaId>1</CriteriaId><CriteriaQuestion>sample string 1</CriteriaQuestion><OffenseDate>2025-12-06T00:14:35.35503-05:00</OffenseDate><State>sample string 5</State></NCSIDisclosure><NCSIDisclosure><Answer>sample string 2</Answer><ChargeDescription>None</ChargeDescription><ChargeDetails>sample string 9</ChargeDetails><ChargeLevel>Felony</ChargeLevel><City>sample string 4</City><CountryCode>sample string 3</CountryCode><CountyFipsCode>6</CountyFipsCode><CourtName>sample string 8</CourtName><CourtType>County</CourtType><CriteriaId>1</CriteriaId><CriteriaQuestion>sample string 1</CriteriaQuestion><OffenseDate>2025-12-06T00:14:35.35503-05:00</OffenseDate><State>sample string 5</State></NCSIDisclosure></Disclosures><Dob>2025-12-06T00:14:35.35503-05:00</Dob><Email>sample string 8</Email><Gender>Female</Gender><LegalFirstName>sample string 2</LegalFirstName><LegalLastName>sample string 4</LegalLastName><LegalMiddleName>sample string 3</LegalMiddleName><LegalNameSince>2025-12-06T00:14:35.35503-05:00</LegalNameSince><LegalPostName>None</LegalPostName><LicenseNumber>sample string 11</LicenseNumber><LicenseState>sample string 10</LicenseState><Phone>sample string 9</Phone><Reference1>sample string 12</Reference1><Reference2>sample string 13</Reference2><Reference3>sample string 14</Reference3><Reference4>sample string 15</Reference4><RegistrationNumber>1</RegistrationNumber><Ssn>sample string 6</Ssn><TiebackReferenceNumber>sample string 1</TiebackReferenceNumber></NCSIBackgroundCheck>

Response Information

Resource Description

NCSIReceipt
NameDescriptionTypeAdditional information
ReceiptNumber

Receipt Number

integer

None.

Message

string

None.

Response Formats

application/json, text/json

Sample:
{
  "ReceiptNumber": 1,
  "Message": "sample string 2"
}

application/xml, text/xml

Sample:
<NCSIReceipt xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/NCSI.API.ViewModels">
  <Message>sample string 2</Message>
  <ReceiptNumber>1</ReceiptNumber>
</NCSIReceipt>

multipart/form-data

Sample:
<NCSIReceipt xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/NCSI.API.ViewModels"><Message>sample string 2</Message><ReceiptNumber>1</ReceiptNumber></NCSIReceipt>