POST api/admin/Customer/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

RequestOfCustomerSearch
NameDescriptionTypeAdditional information

Value

CustomerSearch

None.

Authentication

Authentication

None.

Request Formats

application/json, text/json

Sample:
{
  "Value": {
    "CustomerNumber": 1,
    "DealerLicenseType": "sample string 1",
    "DealerLicenseNumber": 1,
    "DealerLicenseSuffix": 1,
    "DriverLicenseNumber": "sample string 2",
    "RowStartNumber": 1,
    "NumberRowsReturn": 1,
    "SearchKey": 1,
    "FirstName": "sample string 3",
    "LastName": "sample string 4",
    "DateOfBirth": "2024-04-29",
    "FEIDSuffix": 1,
    "FEID": "sample string 5",
    "SocialSecurityNumber": "sample string 6",
    "NaicCode": 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>
    <DealerLicenseType>sample string 1</DealerLicenseType>
    <DealerLicenseNumber>1</DealerLicenseNumber>
    <DealerLicenseSuffix>1</DealerLicenseSuffix>
    <DriverLicenseNumber>sample string 2</DriverLicenseNumber>
    <RowStartNumber>1</RowStartNumber>
    <NumberRowsReturn>1</NumberRowsReturn>
    <SearchKey>1</SearchKey>
    <FirstName>sample string 3</FirstName>
    <LastName>sample string 4</LastName>
    <DateOfBirth>2024-04-29</DateOfBirth>
    <FEIDSuffix>1</FEIDSuffix>
    <FEID>sample string 5</FEID>
    <SocialSecurityNumber>sample string 6</SocialSecurityNumber>
    <NaicCode>1</NaicCode>
  </Value>
</Request>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

ResponseOfSearchResultOfCustomerSearchResult
NameDescriptionTypeAdditional information

Value

SearchResultOfCustomerSearchResult

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": [
      {
        "CustomerNumber": 1,
        "CustomerType": "sample string 1",
        "DriverLicenseNumber": "sample string 2",
        "LastName": "sample string 3",
        "MiddleName": "sample string 4",
        "FirstName": "sample string 5",
        "NameSuffix": "sample string 6",
        "SexCode": "sample string 7",
        "DateOfBirth": "2024-04-29",
        "FEID": "sample string 8",
        "FEIDSuffix": 1,
        "CompanyName": "sample string 9",
        "SalesTaxRegNumber": "sample string 10",
        "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
          }
        ],
        "AddressUpdateEligibilityFlag": true,
        "AddressUpdateIneligibilityReasons": [
          "sample string 1",
          "sample string 2"
        ],
        "DealerLicenseType": "sample string 11",
        "DealerLicenseNumber": 1,
        "DealerLicenseSuffix": 1,
        "LicenseStatusCode": "sample string 12",
        "LocationStatusCode": "sample string 13",
        "MilitaryPersonType": "sample string 14",
        "ResidenceCounty": 1,
        "ResidenceStatus": "sample string 15",
        "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": "2024-04-29",
            "CustomerNumber": 1
          },
          {
            "StopIssueType": "sample string 1",
            "StopIssueTypeDescription": "sample string 2",
            "StopIssueDate": "2024-04-29",
            "CustomerNumber": 1
          }
        ],
        "NAICNumber": 1
      },
      {
        "CustomerNumber": 1,
        "CustomerType": "sample string 1",
        "DriverLicenseNumber": "sample string 2",
        "LastName": "sample string 3",
        "MiddleName": "sample string 4",
        "FirstName": "sample string 5",
        "NameSuffix": "sample string 6",
        "SexCode": "sample string 7",
        "DateOfBirth": "2024-04-29",
        "FEID": "sample string 8",
        "FEIDSuffix": 1,
        "CompanyName": "sample string 9",
        "SalesTaxRegNumber": "sample string 10",
        "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
          }
        ],
        "AddressUpdateEligibilityFlag": true,
        "AddressUpdateIneligibilityReasons": [
          "sample string 1",
          "sample string 2"
        ],
        "DealerLicenseType": "sample string 11",
        "DealerLicenseNumber": 1,
        "DealerLicenseSuffix": 1,
        "LicenseStatusCode": "sample string 12",
        "LocationStatusCode": "sample string 13",
        "MilitaryPersonType": "sample string 14",
        "ResidenceCounty": 1,
        "ResidenceStatus": "sample string 15",
        "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": "2024-04-29",
            "CustomerNumber": 1
          },
          {
            "StopIssueType": "sample string 1",
            "StopIssueTypeDescription": "sample string 2",
            "StopIssueDate": "2024-04-29",
            "CustomerNumber": 1
          }
        ],
        "NAICNumber": 1
      }
    ],
    "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": "955a9a97-a997-4e4e-9a6b-de05d6e327a4"
}

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>
      <CustomerSearchResult>
        <CustomerNumber>1</CustomerNumber>
        <CustomerType>sample string 1</CustomerType>
        <DriverLicenseNumber>sample string 2</DriverLicenseNumber>
        <LastName>sample string 3</LastName>
        <MiddleName>sample string 4</MiddleName>
        <FirstName>sample string 5</FirstName>
        <NameSuffix>sample string 6</NameSuffix>
        <SexCode>sample string 7</SexCode>
        <DateOfBirth>2024-04-29</DateOfBirth>
        <FEID>sample string 8</FEID>
        <FEIDSuffix>1</FEIDSuffix>
        <CompanyName>sample string 9</CompanyName>
        <SalesTaxRegNumber>sample string 10</SalesTaxRegNumber>
        <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>
        <AddressUpdateEligibilityFlag>true</AddressUpdateEligibilityFlag>
        <AddressUpdateIneligibilityReasons>
          <string>sample string 1</string>
          <string>sample string 2</string>
        </AddressUpdateIneligibilityReasons>
        <DealerLicenseType>sample string 11</DealerLicenseType>
        <DealerLicenseNumber>1</DealerLicenseNumber>
        <DealerLicenseSuffix>1</DealerLicenseSuffix>
        <LicenseStatusCode>sample string 12</LicenseStatusCode>
        <LocationStatusCode>sample string 13</LocationStatusCode>
        <MilitaryPersonType>sample string 14</MilitaryPersonType>
        <ResidenceCounty>1</ResidenceCounty>
        <ResidenceStatus>sample string 15</ResidenceStatus>
        <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>2024-04-29</StopIssueDate>
            <CustomerNumber>1</CustomerNumber>
          </CustomerStop>
          <CustomerStop>
            <StopIssueType>sample string 1</StopIssueType>
            <StopIssueTypeDescription>sample string 2</StopIssueTypeDescription>
            <StopIssueDate>2024-04-29</StopIssueDate>
            <CustomerNumber>1</CustomerNumber>
          </CustomerStop>
        </CustomerStopList>
        <NAICNumber>1</NAICNumber>
      </CustomerSearchResult>
      <CustomerSearchResult>
        <CustomerNumber>1</CustomerNumber>
        <CustomerType>sample string 1</CustomerType>
        <DriverLicenseNumber>sample string 2</DriverLicenseNumber>
        <LastName>sample string 3</LastName>
        <MiddleName>sample string 4</MiddleName>
        <FirstName>sample string 5</FirstName>
        <NameSuffix>sample string 6</NameSuffix>
        <SexCode>sample string 7</SexCode>
        <DateOfBirth>2024-04-29</DateOfBirth>
        <FEID>sample string 8</FEID>
        <FEIDSuffix>1</FEIDSuffix>
        <CompanyName>sample string 9</CompanyName>
        <SalesTaxRegNumber>sample string 10</SalesTaxRegNumber>
        <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>
        <AddressUpdateEligibilityFlag>true</AddressUpdateEligibilityFlag>
        <AddressUpdateIneligibilityReasons>
          <string>sample string 1</string>
          <string>sample string 2</string>
        </AddressUpdateIneligibilityReasons>
        <DealerLicenseType>sample string 11</DealerLicenseType>
        <DealerLicenseNumber>1</DealerLicenseNumber>
        <DealerLicenseSuffix>1</DealerLicenseSuffix>
        <LicenseStatusCode>sample string 12</LicenseStatusCode>
        <LocationStatusCode>sample string 13</LocationStatusCode>
        <MilitaryPersonType>sample string 14</MilitaryPersonType>
        <ResidenceCounty>1</ResidenceCounty>
        <ResidenceStatus>sample string 15</ResidenceStatus>
        <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>2024-04-29</StopIssueDate>
            <CustomerNumber>1</CustomerNumber>
          </CustomerStop>
          <CustomerStop>
            <StopIssueType>sample string 1</StopIssueType>
            <StopIssueTypeDescription>sample string 2</StopIssueTypeDescription>
            <StopIssueDate>2024-04-29</StopIssueDate>
            <CustomerNumber>1</CustomerNumber>
          </CustomerStop>
        </CustomerStopList>
        <NAICNumber>1</NAICNumber>
      </CustomerSearchResult>
    </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>955a9a97-a997-4e4e-9a6b-de05d6e327a4</RequestId>
</Response>