GET/I9s

This API returns a collection of I-9s. Optional page_size and page parameters can be passed in order to limit the results. Results include the I-9 record Guardian ID which can be used in a subsequent GET request to obtain additional details related to the I-9. For additional parameter information access the i9s data model section to review field information.

A maximum of 50 I-9s are returned in the response. The ‘links’ section of the response includes paging information. Use this information to obtain additional collections of I-9 records, e.g. GET https://<server>/v1/i9s?page=2.

Method

GET

Resource Information

Requires authentication?	YES
Response formats	JSON

Parameters

Parameter	Required	Description
page	No	specifies the page number from where you want to begin accessing records
firstName	string	Employee’s first name
lastName	string	Employee’s last name
startDate	date string	Employee’s I-9 hire date
i9Expiration	date string	The date I-9 reverification or receipt update is due

Example
Request Example: GET https://<server>/v1/i9s
Response Example:

{
 ""searchResult"": [
 {
 ""lastName"": Adams,
 ""emailAddress"": null,
 ""id"": 2067713,
 ""firstName"": Betty
 },
 {
 ""lastName"": ""Drummond"",
 ""emailAddress"": """",
 ""id"": 1745835,
 ""firstName"": ""Elise""
 },
 {
 ""lastName"": ""Smith"",
 ""emailAddress"": """",
 ""id"": 2067702,
 ""firstName"": ""Michael""
 },
 {
 ""lastName"": ""Bronson"",
 ""emailAddress"": ""ebronson@email.com"",
 ""id"": 1933290,
 ""firstName"": ""Ethan""
 }
],
 ""links"": [
 {
 ""href"": ""/v1/i9s"",
 ""rel"": ""self""
 },
 {
 ""href"": ""/v1/i9s?page=1"",
 ""rel"": ""first""
 },
 {
 ""href"": ""/v1/i9s?page=2"",
 ""rel"": ""last""
 },
 {
 ""href"": ""/v1/i9s?page=2"",
 ""rel"": ""next""
 },
 {
 ""href"": ""/v1/i9s?page=2"",
 ""rel"": ""previous""
 }
 ]
}

Single Record Query String Example
Request Example: GET https://<server>/v1/i9s?firstName=Judy&lastName=Jones
Single Record Response Example:

{
 ""searchResult"": [
 {
 ""lastName"": ""Jones"",
 ""emailAddress"": null,
 ""id"": 1933551,
 ""firstName"": ""Judy""
 }
 ],
 ""links"": [
 {
 ""href"": ""/v1/i9s"",
 ""rel"": ""self""
 },
 {
 ""href"": ""/v1/i9s?page=1"",
 ""rel"": ""first""
 },
 {
 ""href"": ""/v1/i9s?page=1"",
 ""rel"": ""last""
 },
 {
 ""href"": ""/v1/i9s?page=1"",
 ""rel"": ""next""
 },
 {
 ""href"": ""/v1/i9s?page=1"",
 ""rel"": ""previous""
 }
 ]
}

Single Record Request Example
Request: GET https://<server>/v1/i9s/<id>
Single Record Response Example:

{
 ""translatorLastName"": null,
 ""translatorZip"": null,
 ""i9Expiration"": null,
 ""listA2DocNumber"": null,
 ""links"": [
 {
 ""href"": ""/v1/i9s/2067713"",
 ""rel"": ""self""
 }
 ],
 ""startDate"": null,
 ""addressStreet"": null,
 ""listCDocTitle"": null,
 ""dateCompleted"": null,
 ""employerFirstName"": null,
 ""listA3DocIssuer"": null,
 ""listA1DocNumber"": null,
 ""listA3DocNumber"": null,
 ""translatorCity"": null,
 ""id"": 2067713,
 ""listA3DocExpiration"": null,
 ""listCDocIssuer"": null,
 ""signedDateEmployer"": null,
 ""signedDateTranslator"": null,
 ""listA2DocIssuer"": null,
 ""alienNumber"": null,
 ""listA1DocExpiration"": null,
 ""otherName"": null,
 ""dateDue"": null,
 ""employerAddress"": null,
 ""employerState"": null,
 ""dateOfBirth"": null,
 ""listCDocNumber"": null,
 ""workAuthorization"": null,
 ""phoneNumber"": null,
 ""firstName"": null,
 ""signedDateEmployee"": null,
 ""formType"": 0,
 ""employerCity"": null,
 ""foreignPassportCountry"": null,
 ""listBDocTitle"": null,
 ""i9Status"": ""Section 1 Incomplete"",
 ""listA2DocExpiration"": null,
 ""employerTitle"": null,
 ""listA3DocTitle"": null,
 ""i9Notes"": null,
 ""listBDocIssuer"": null,
 ""dateCreated"": ""2017-11-01T15:18:34.523953"",
 ""translatorAddress"": null,
 ""emailAddress"": null,
 ""formVersion"": ""8/23/17"",
 ""employerZip"": null,
 ""listA1DocTitle"": null,
 ""addressCity"": null,
 ""foreignPassportNumber"": null,
 ""listA2DocTitle"": null,
 ""admissionNumber"": null,
 ""listA1DocIssuer"": null,
 ""listCDocExpiration"": null,
 ""lastName"": null,
 ""addressState"": null,
 ""middleInitial"": null,
 ""translatorState"": null,
 ""listBDocExpiration"": null,
 ""attestation"": null,
 ""ssn"": null,
 ""listBDocNumber"": null,
 ""employerLastName"": null,
 ""addressApartment"": null,
 ""employerBusiness"": null,
 ""dateApproved"": null,
 ""translatorFirstName"": null,
 ""addressZip"": null
}