POST api/BackgroundCheck
Create a new background check
Request Information
URI Parameters
None.
Body Parameters
NCSIBackgroundCheck| Name | Description | Type | Additional 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 |
|
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
{
"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
<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
<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| Name | Description | Type | Additional information |
|---|---|---|---|
| ReceiptNumber |
Receipt Number |
integer |
None. |
| Message | string |
None. |
Response Formats
application/json, text/json
{
"ReceiptNumber": 1,
"Message": "sample string 2"
}
application/xml, text/xml
<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
<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>