POST api/admin/Employee/Search

Click on the link to the left for code examples. Also refer to the DHSMV System Specification document for additional insight.

Request Information

URI Parameters

None.

Body Parameters

RequestOfEmployeeSearch

Name	Description	Type	Additional information
Value		EmployeeSearch	None.
Authentication		Authentication	None.

Request Formats

application/json, text/json

Sample:

{
  "Value": {
    "CustomerNumber": 1,
    "DriverLicenseNumber": "sample string 1",
    "SocialSecurityNumber": "sample string 2",
    "FirstName": "sample string 3",
    "MiddleName": "sample string 4",
    "LastName": "sample string 5",
    "DateOfBirth": "2025-04-24",
    "AgentCustomerNumber": 1,
    "DealerLicenseType": "sample string 6",
    "DealerLicenseNumber": 1,
    "DealerLicenseSuffix": 1,
    "EmployeeStatus": "sample string 7",
    "EmployeeStopFlag": true,
    "RowStartNumber": 1,
    "NumberRowsReturn": 1,
    "SearchKey": 1
  },
  "Authentication": {
    "AgentCustomerNumber": 1,
    "DealerLicenseType": "sample string 1",
    "DealerLicenseNumber": 1,
    "DealerLicenseSuffix": 1,
    "EmpCustomerNumber": 1,
    "LogNumber": 1,
    "DealerLicensePin": "sample string 2",
    "EmployeeType": "sample string 3"
  }
}

application/xml, text/xml

Sample:

<Request xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Authentication>
    <AgentCustomerNumber>1</AgentCustomerNumber>
    <DealerLicenseType>sample string 1</DealerLicenseType>
    <DealerLicenseNumber>1</DealerLicenseNumber>
    <DealerLicenseSuffix>1</DealerLicenseSuffix>
    <EmpCustomerNumber>1</EmpCustomerNumber>
    <LogNumber>1</LogNumber>
    <DealerLicensePin>sample string 2</DealerLicensePin>
    <EmployeeType>sample string 3</EmployeeType>
  </Authentication>
  <Value>
    <CustomerNumber>1</CustomerNumber>
    <DriverLicenseNumber>sample string 1</DriverLicenseNumber>
    <SocialSecurityNumber>sample string 2</SocialSecurityNumber>
    <FirstName>sample string 3</FirstName>
    <MiddleName>sample string 4</MiddleName>
    <LastName>sample string 5</LastName>
    <DateOfBirth>2025-04-24</DateOfBirth>
    <AgentCustomerNumber>1</AgentCustomerNumber>
    <DealerLicenseType>sample string 6</DealerLicenseType>
    <DealerLicenseNumber>1</DealerLicenseNumber>
    <DealerLicenseSuffix>1</DealerLicenseSuffix>
    <EmployeeStatus>sample string 7</EmployeeStatus>
    <EmployeeStopFlag>true</EmployeeStopFlag>
    <RowStartNumber>1</RowStartNumber>
    <NumberRowsReturn>1</NumberRowsReturn>
    <SearchKey>1</SearchKey>
  </Value>
</Request>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

ResponseOfSearchResultOfEmployeeSearchResult

Name	Type	Additional information
Value	SearchResultOfEmployeeSearchResult	None.
ErrorMessages	Collection of ErrorMessage	None.
InfoMessages	Collection of InfoMessage	None.
LogNumber	integer	None.
Notifications	Collection of Notification	None.
RequestId	globally unique identifier	None.

Response Formats

application/json, text/json

Sample:

{
  "Value": {
    "Results": [
      {
        "EmployeeType": "sample string 1",
        "EmployeeStatus": "sample string 2",
        "CustomerNumber": 1,
        "AgentCustomerNumber": 1,
        "SPCustomerNumber": 1,
        "DealerLicenseType": "sample string 3",
        "DealerLicenseNumber": 1,
        "DealerLicenseSuffix": 1,
        "EmployeeStopFlag": true,
        "StartDate": "2025-04-24",
        "EndDate": "2025-04-24",
        "Customer": {
          "CustomerNumber": 1,
          "CustomerType": "sample string 1",
          "DriverLicenseNumber": "sample string 2",
          "FirstName": "sample string 3",
          "MiddleName": "sample string 4",
          "LastName": "sample string 5",
          "NameSuffix": "sample string 6",
          "DateOfBirth": "2025-04-24",
          "SexCode": "sample string 7",
          "FEID": "sample string 8",
          "FEIDSuffix": 1,
          "CompanyName": "sample string 9",
          "SalesTaxRegNumber": "sample string 10",
          "MilitaryPersonType": "sample string 11",
          "ResidenceCounty": 1,
          "ResidenceStatus": "sample string 12",
          "AddressList": [
            {
              "AddressNumber": 1,
              "AddressTypeCode": "sample string 1",
              "StreetAddress": "sample string 2",
              "City": "sample string 3",
              "StateCode": "sample string 4",
              "ZipCode": "sample string 5",
              "ZipPlus": "sample string 6",
              "CountyCode": 1,
              "CountryCode": "sample string 7",
              "ForeignPostalCode": "sample string 8",
              "PhysicalLocation": "sample string 9",
              "UpdateFlag": true
            },
            {
              "AddressNumber": 1,
              "AddressTypeCode": "sample string 1",
              "StreetAddress": "sample string 2",
              "City": "sample string 3",
              "StateCode": "sample string 4",
              "ZipCode": "sample string 5",
              "ZipPlus": "sample string 6",
              "CountyCode": 1,
              "CountryCode": "sample string 7",
              "ForeignPostalCode": "sample string 8",
              "PhysicalLocation": "sample string 9",
              "UpdateFlag": true
            }
          ],
          "PhoneList": [
            {
              "AreaCode": 1,
              "Phone": 1,
              "PhoneCode": "sample string 1"
            },
            {
              "AreaCode": 1,
              "Phone": 1,
              "PhoneCode": "sample string 1"
            }
          ],
          "CustomerStopList": [
            {
              "StopIssueType": "sample string 1",
              "StopIssueTypeDescription": "sample string 2",
              "StopIssueDate": "2025-04-24",
              "CustomerNumber": 1
            },
            {
              "StopIssueType": "sample string 1",
              "StopIssueTypeDescription": "sample string 2",
              "StopIssueDate": "2025-04-24",
              "CustomerNumber": 1
            }
          ],
          "DealerLicenseType": "sample string 13",
          "DealerLicenseNumber": 1,
          "DealerLicenseSuffix": 1,
          "LicenseStatusCode": "sample string 14",
          "LocationStatusCode": "sample string 15"
        }
      },
      {
        "EmployeeType": "sample string 1",
        "EmployeeStatus": "sample string 2",
        "CustomerNumber": 1,
        "AgentCustomerNumber": 1,
        "SPCustomerNumber": 1,
        "DealerLicenseType": "sample string 3",
        "DealerLicenseNumber": 1,
        "DealerLicenseSuffix": 1,
        "EmployeeStopFlag": true,
        "StartDate": "2025-04-24",
        "EndDate": "2025-04-24",
        "Customer": {
          "CustomerNumber": 1,
          "CustomerType": "sample string 1",
          "DriverLicenseNumber": "sample string 2",
          "FirstName": "sample string 3",
          "MiddleName": "sample string 4",
          "LastName": "sample string 5",
          "NameSuffix": "sample string 6",
          "DateOfBirth": "2025-04-24",
          "SexCode": "sample string 7",
          "FEID": "sample string 8",
          "FEIDSuffix": 1,
          "CompanyName": "sample string 9",
          "SalesTaxRegNumber": "sample string 10",
          "MilitaryPersonType": "sample string 11",
          "ResidenceCounty": 1,
          "ResidenceStatus": "sample string 12",
          "AddressList": [
            {
              "AddressNumber": 1,
              "AddressTypeCode": "sample string 1",
              "StreetAddress": "sample string 2",
              "City": "sample string 3",
              "StateCode": "sample string 4",
              "ZipCode": "sample string 5",
              "ZipPlus": "sample string 6",
              "CountyCode": 1,
              "CountryCode": "sample string 7",
              "ForeignPostalCode": "sample string 8",
              "PhysicalLocation": "sample string 9",
              "UpdateFlag": true
            },
            {
              "AddressNumber": 1,
              "AddressTypeCode": "sample string 1",
              "StreetAddress": "sample string 2",
              "City": "sample string 3",
              "StateCode": "sample string 4",
              "ZipCode": "sample string 5",
              "ZipPlus": "sample string 6",
              "CountyCode": 1,
              "CountryCode": "sample string 7",
              "ForeignPostalCode": "sample string 8",
              "PhysicalLocation": "sample string 9",
              "UpdateFlag": true
            }
          ],
          "PhoneList": [
            {
              "AreaCode": 1,
              "Phone": 1,
              "PhoneCode": "sample string 1"
            },
            {
              "AreaCode": 1,
              "Phone": 1,
              "PhoneCode": "sample string 1"
            }
          ],
          "CustomerStopList": [
            {
              "StopIssueType": "sample string 1",
              "StopIssueTypeDescription": "sample string 2",
              "StopIssueDate": "2025-04-24",
              "CustomerNumber": 1
            },
            {
              "StopIssueType": "sample string 1",
              "StopIssueTypeDescription": "sample string 2",
              "StopIssueDate": "2025-04-24",
              "CustomerNumber": 1
            }
          ],
          "DealerLicenseType": "sample string 13",
          "DealerLicenseNumber": 1,
          "DealerLicenseSuffix": 1,
          "LicenseStatusCode": "sample string 14",
          "LocationStatusCode": "sample string 15"
        }
      }
    ],
    "TotalRecordCount": 1
  },
  "ErrorMessages": [
    {
      "Parameters": [
        "sample string 1",
        "sample string 2"
      ],
      "DeveloperMessage": "sample string 1",
      "ErrorCode": 401,
      "ExceptionMessage": ""
    },
    {
      "Parameters": [
        "sample string 1",
        "sample string 2"
      ],
      "DeveloperMessage": "sample string 1",
      "ErrorCode": 401,
      "ExceptionMessage": ""
    }
  ],
  "InfoMessages": [
    {
      "Message": "sample string 1"
    },
    {
      "Message": "sample string 1"
    }
  ],
  "LogNumber": 1,
  "Notifications": [
    {
      "NotificationId": 1,
      "NotificationType": "sample string 1"
    },
    {
      "NotificationId": 1,
      "NotificationType": "sample string 1"
    }
  ],
  "RequestId": "0e5d4b95-1597-47dc-9bdb-903fe0bde8a3"
}

application/xml, text/xml

Sample:

<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Value>
    <Results>
      <EmployeeSearchResult>
        <EmployeeType>sample string 1</EmployeeType>
        <EmployeeStatus>sample string 2</EmployeeStatus>
        <CustomerNumber>1</CustomerNumber>
        <AgentCustomerNumber>1</AgentCustomerNumber>
        <SPCustomerNumber>1</SPCustomerNumber>
        <DealerLicenseType>sample string 3</DealerLicenseType>
        <DealerLicenseNumber>1</DealerLicenseNumber>
        <DealerLicenseSuffix>1</DealerLicenseSuffix>
        <EmployeeStopFlag>true</EmployeeStopFlag>
        <StartDate>2025-04-24</StartDate>
        <EndDate>2025-04-24</EndDate>
        <Customer>
          <CustomerNumber>1</CustomerNumber>
          <CustomerType>sample string 1</CustomerType>
          <DriverLicenseNumber>sample string 2</DriverLicenseNumber>
          <FirstName>sample string 3</FirstName>
          <MiddleName>sample string 4</MiddleName>
          <LastName>sample string 5</LastName>
          <NameSuffix>sample string 6</NameSuffix>
          <DateOfBirth>2025-04-24</DateOfBirth>
          <SexCode>sample string 7</SexCode>
          <FEID>sample string 8</FEID>
          <FEIDSuffix>1</FEIDSuffix>
          <CompanyName>sample string 9</CompanyName>
          <SalesTaxRegNumber>sample string 10</SalesTaxRegNumber>
          <MilitaryPersonType>sample string 11</MilitaryPersonType>
          <ResidenceCounty>1</ResidenceCounty>
          <ResidenceStatus>sample string 12</ResidenceStatus>
          <AddressList>
            <Address>
              <AddressNumber>1</AddressNumber>
              <AddressTypeCode>sample string 1</AddressTypeCode>
              <StreetAddress>sample string 2</StreetAddress>
              <City>sample string 3</City>
              <StateCode>sample string 4</StateCode>
              <ZipCode>sample string 5</ZipCode>
              <ZipPlus>sample string 6</ZipPlus>
              <CountyCode>1</CountyCode>
              <CountryCode>sample string 7</CountryCode>
              <ForeignPostalCode>sample string 8</ForeignPostalCode>
              <PhysicalLocation>sample string 9</PhysicalLocation>
              <UpdateFlag>true</UpdateFlag>
            </Address>
            <Address>
              <AddressNumber>1</AddressNumber>
              <AddressTypeCode>sample string 1</AddressTypeCode>
              <StreetAddress>sample string 2</StreetAddress>
              <City>sample string 3</City>
              <StateCode>sample string 4</StateCode>
              <ZipCode>sample string 5</ZipCode>
              <ZipPlus>sample string 6</ZipPlus>
              <CountyCode>1</CountyCode>
              <CountryCode>sample string 7</CountryCode>
              <ForeignPostalCode>sample string 8</ForeignPostalCode>
              <PhysicalLocation>sample string 9</PhysicalLocation>
              <UpdateFlag>true</UpdateFlag>
            </Address>
          </AddressList>
          <PhoneList>
            <PhoneNumber>
              <AreaCode>1</AreaCode>
              <Phone>1</Phone>
              <PhoneCode>sample string 1</PhoneCode>
            </PhoneNumber>
            <PhoneNumber>
              <AreaCode>1</AreaCode>
              <Phone>1</Phone>
              <PhoneCode>sample string 1</PhoneCode>
            </PhoneNumber>
          </PhoneList>
          <CustomerStopList>
            <CustomerStop>
              <StopIssueType>sample string 1</StopIssueType>
              <StopIssueTypeDescription>sample string 2</StopIssueTypeDescription>
              <StopIssueDate>2025-04-24</StopIssueDate>
              <CustomerNumber>1</CustomerNumber>
            </CustomerStop>
            <CustomerStop>
              <StopIssueType>sample string 1</StopIssueType>
              <StopIssueTypeDescription>sample string 2</StopIssueTypeDescription>
              <StopIssueDate>2025-04-24</StopIssueDate>
              <CustomerNumber>1</CustomerNumber>
            </CustomerStop>
          </CustomerStopList>
          <DealerLicenseType>sample string 13</DealerLicenseType>
          <DealerLicenseNumber>1</DealerLicenseNumber>
          <DealerLicenseSuffix>1</DealerLicenseSuffix>
          <LicenseStatusCode>sample string 14</LicenseStatusCode>
          <LocationStatusCode>sample string 15</LocationStatusCode>
        </Customer>
      </EmployeeSearchResult>
      <EmployeeSearchResult>
        <EmployeeType>sample string 1</EmployeeType>
        <EmployeeStatus>sample string 2</EmployeeStatus>
        <CustomerNumber>1</CustomerNumber>
        <AgentCustomerNumber>1</AgentCustomerNumber>
        <SPCustomerNumber>1</SPCustomerNumber>
        <DealerLicenseType>sample string 3</DealerLicenseType>
        <DealerLicenseNumber>1</DealerLicenseNumber>
        <DealerLicenseSuffix>1</DealerLicenseSuffix>
        <EmployeeStopFlag>true</EmployeeStopFlag>
        <StartDate>2025-04-24</StartDate>
        <EndDate>2025-04-24</EndDate>
        <Customer>
          <CustomerNumber>1</CustomerNumber>
          <CustomerType>sample string 1</CustomerType>
          <DriverLicenseNumber>sample string 2</DriverLicenseNumber>
          <FirstName>sample string 3</FirstName>
          <MiddleName>sample string 4</MiddleName>
          <LastName>sample string 5</LastName>
          <NameSuffix>sample string 6</NameSuffix>
          <DateOfBirth>2025-04-24</DateOfBirth>
          <SexCode>sample string 7</SexCode>
          <FEID>sample string 8</FEID>
          <FEIDSuffix>1</FEIDSuffix>
          <CompanyName>sample string 9</CompanyName>
          <SalesTaxRegNumber>sample string 10</SalesTaxRegNumber>
          <MilitaryPersonType>sample string 11</MilitaryPersonType>
          <ResidenceCounty>1</ResidenceCounty>
          <ResidenceStatus>sample string 12</ResidenceStatus>
          <AddressList>
            <Address>
              <AddressNumber>1</AddressNumber>
              <AddressTypeCode>sample string 1</AddressTypeCode>
              <StreetAddress>sample string 2</StreetAddress>
              <City>sample string 3</City>
              <StateCode>sample string 4</StateCode>
              <ZipCode>sample string 5</ZipCode>
              <ZipPlus>sample string 6</ZipPlus>
              <CountyCode>1</CountyCode>
              <CountryCode>sample string 7</CountryCode>
              <ForeignPostalCode>sample string 8</ForeignPostalCode>
              <PhysicalLocation>sample string 9</PhysicalLocation>
              <UpdateFlag>true</UpdateFlag>
            </Address>
            <Address>
              <AddressNumber>1</AddressNumber>
              <AddressTypeCode>sample string 1</AddressTypeCode>
              <StreetAddress>sample string 2</StreetAddress>
              <City>sample string 3</City>
              <StateCode>sample string 4</StateCode>
              <ZipCode>sample string 5</ZipCode>
              <ZipPlus>sample string 6</ZipPlus>
              <CountyCode>1</CountyCode>
              <CountryCode>sample string 7</CountryCode>
              <ForeignPostalCode>sample string 8</ForeignPostalCode>
              <PhysicalLocation>sample string 9</PhysicalLocation>
              <UpdateFlag>true</UpdateFlag>
            </Address>
          </AddressList>
          <PhoneList>
            <PhoneNumber>
              <AreaCode>1</AreaCode>
              <Phone>1</Phone>
              <PhoneCode>sample string 1</PhoneCode>
            </PhoneNumber>
            <PhoneNumber>
              <AreaCode>1</AreaCode>
              <Phone>1</Phone>
              <PhoneCode>sample string 1</PhoneCode>
            </PhoneNumber>
          </PhoneList>
          <CustomerStopList>
            <CustomerStop>
              <StopIssueType>sample string 1</StopIssueType>
              <StopIssueTypeDescription>sample string 2</StopIssueTypeDescription>
              <StopIssueDate>2025-04-24</StopIssueDate>
              <CustomerNumber>1</CustomerNumber>
            </CustomerStop>
            <CustomerStop>
              <StopIssueType>sample string 1</StopIssueType>
              <StopIssueTypeDescription>sample string 2</StopIssueTypeDescription>
              <StopIssueDate>2025-04-24</StopIssueDate>
              <CustomerNumber>1</CustomerNumber>
            </CustomerStop>
          </CustomerStopList>
          <DealerLicenseType>sample string 13</DealerLicenseType>
          <DealerLicenseNumber>1</DealerLicenseNumber>
          <DealerLicenseSuffix>1</DealerLicenseSuffix>
          <LicenseStatusCode>sample string 14</LicenseStatusCode>
          <LocationStatusCode>sample string 15</LocationStatusCode>
        </Customer>
      </EmployeeSearchResult>
    </Results>
    <TotalRecordCount>1</TotalRecordCount>
  </Value>
  <ErrorMessages>
    <ErrorMessage>
      <Parameters>
        <string>sample string 1</string>
        <string>sample string 2</string>
      </Parameters>
      <DeveloperMessage>sample string 1</DeveloperMessage>
      <ErrorCode>AuthorizationError</ErrorCode>
    </ErrorMessage>
    <ErrorMessage>
      <Parameters>
        <string>sample string 1</string>
        <string>sample string 2</string>
      </Parameters>
      <DeveloperMessage>sample string 1</DeveloperMessage>
      <ErrorCode>AuthorizationError</ErrorCode>
    </ErrorMessage>
  </ErrorMessages>
  <InfoMessages>
    <InfoMessage>
      <Message>sample string 1</Message>
    </InfoMessage>
    <InfoMessage>
      <Message>sample string 1</Message>
    </InfoMessage>
  </InfoMessages>
  <LogNumber>1</LogNumber>
  <Notifications>
    <Notification>
      <NotificationId>1</NotificationId>
      <NotificationType>sample string 1</NotificationType>
    </Notification>
    <Notification>
      <NotificationId>1</NotificationId>
      <NotificationType>sample string 1</NotificationType>
    </Notification>
  </Notifications>
  <RequestId>0e5d4b95-1597-47dc-9bdb-903fe0bde8a3</RequestId>
</Response>