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
}