PullProspectByDealNumber

Pulls a sales prospect (buyer) by deal number.

Request Information

Parameters

Name	Description	Type	Additional information
storeId		integer	Required
dealNumber		integer	Required

Response Information

Resource Description

Prospect

Name	Description	Type
DealKey		string
Attributes		IdentityProfile
References		ProspectReferences
DriverLicenseNumber		string
Upsource		string
ErrorMessage		string
PhysicalAddress	Physical address also known as garaging address.	Address
PhysicalDamageInsurance	Physical damage insurance (PDI).	PhysicalDamageInsurance
Placement		StorePlacement

Sample Response

<Prospect xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DealerBuilt.BaseApi">
  <Placement>
    <GroupId>8</GroupId>
    <GroupName>sample string 9</GroupName>
    <EnvironmentId>7</EnvironmentId>
    <EnvironmentType>Undefined</EnvironmentType>
    <DealerId>6</DealerId>
    <SourceId>5</SourceId>
    <CompanyId>3</CompanyId>
    <CompanyName>sample string 4</CompanyName>
    <StoreId>1</StoreId>
    <StoreName>sample string 2</StoreName>
  </Placement>
  <Attributes xmlns:d2p1="http://schemas.datacontract.org/2004/07/DealerBuilt.Models">
    <d2p1:Address1>sample string 1</d2p1:Address1>
    <d2p1:Address2>sample string 3</d2p1:Address2>
    <d2p1:BirthDate>2025-04-28T13:54:48.8907283Z</d2p1:BirthDate>
    <d2p1:City>sample string 6</d2p1:City>
    <d2p1:CitySubDivisionName>sample string 20</d2p1:CitySubDivisionName>
    <d2p1:Country>sample string 16</d2p1:Country>
    <d2p1:County>sample string 14</d2p1:County>
    <d2p1:EmailAddress>sample string 12</d2p1:EmailAddress>
    <d2p1:PersonalName>
      <d2p1:FirstName>sample string 1</d2p1:FirstName>
      <d2p1:LastName>sample string 2</d2p1:LastName>
      <d2p1:MiddleName>sample string 3</d2p1:MiddleName>
      <d2p1:SingularName>sample string 4</d2p1:SingularName>
      <d2p1:Suffix>sample string 5</d2p1:Suffix>
      <d2p1:Title>None</d2p1:Title>
    </d2p1:PersonalName>
    <d2p1:PhoneNumbers>
      <d2p1:PhoneNumber>
        <d2p1:Digits>sample string 1</d2p1:Digits>
        <d2p1:NumberType>Unknown</d2p1:NumberType>
      </d2p1:PhoneNumber>
      <d2p1:PhoneNumber>
        <d2p1:Digits>sample string 1</d2p1:Digits>
        <d2p1:NumberType>Unknown</d2p1:NumberType>
      </d2p1:PhoneNumber>
    </d2p1:PhoneNumbers>
    <d2p1:Sex>Unknown</d2p1:Sex>
    <d2p1:SpouseAddress1>sample string 2</d2p1:SpouseAddress1>
    <d2p1:SpouseAddress2>sample string 4</d2p1:SpouseAddress2>
    <d2p1:SpouseBirthDate>2025-04-28T13:54:48.8907283Z</d2p1:SpouseBirthDate>
    <d2p1:SpouseCity>sample string 9</d2p1:SpouseCity>
    <d2p1:SpouseCountry>sample string 17</d2p1:SpouseCountry>
    <d2p1:SpouseCounty>sample string 15</d2p1:SpouseCounty>
    <d2p1:SpouseEmailAddress>sample string 13</d2p1:SpouseEmailAddress>
    <d2p1:SpouseName>
      <d2p1:FirstName>sample string 1</d2p1:FirstName>
      <d2p1:LastName>sample string 2</d2p1:LastName>
      <d2p1:MiddleName>sample string 3</d2p1:MiddleName>
      <d2p1:SingularName>sample string 4</d2p1:SingularName>
      <d2p1:Suffix>sample string 5</d2p1:Suffix>
      <d2p1:Title>None</d2p1:Title>
    </d2p1:SpouseName>
    <d2p1:SpousePhoneNumbers>
      <d2p1:PhoneNumber>
        <d2p1:Digits>sample string 1</d2p1:Digits>
        <d2p1:NumberType>Unknown</d2p1:NumberType>
      </d2p1:PhoneNumber>
      <d2p1:PhoneNumber>
        <d2p1:Digits>sample string 1</d2p1:Digits>
        <d2p1:NumberType>Unknown</d2p1:NumberType>
      </d2p1:PhoneNumber>
    </d2p1:SpousePhoneNumbers>
    <d2p1:SpouseSex>Unknown</d2p1:SpouseSex>
    <d2p1:SpouseSsn>sample string 19</d2p1:SpouseSsn>
    <d2p1:SpouseState>sample string 10</d2p1:SpouseState>
    <d2p1:SpouseZip>sample string 11</d2p1:SpouseZip>
    <d2p1:Ssn>sample string 18</d2p1:Ssn>
    <d2p1:State>sample string 7</d2p1:State>
    <d2p1:Title>sample string 5</d2p1:Title>
    <d2p1:Zip>sample string 8</d2p1:Zip>
  </Attributes>
  <DealKey>sample string 1</DealKey>
  <DriverLicenseNumber>sample string 2</DriverLicenseNumber>
  <ErrorMessage>sample string 4</ErrorMessage>
  <PhysicalAddress xmlns:d2p1="http://schemas.datacontract.org/2004/07/DealerBuilt.Models">
    <d2p1:City>sample string 3</d2p1:City>
    <d2p1:Country>sample string 7</d2p1:Country>
    <d2p1:County>sample string 6</d2p1:County>
    <d2p1:Line1>sample string 1</d2p1:Line1>
    <d2p1:Line2>sample string 2</d2p1:Line2>
    <d2p1:State>sample string 4</d2p1:State>
    <d2p1:Zip>sample string 5</d2p1:Zip>
  </PhysicalAddress>
  <PhysicalDamageInsurance xmlns:d2p1="http://schemas.datacontract.org/2004/07/DealerBuilt.Models">
    <d2p1:AgentAddress>sample string 7</d2p1:AgentAddress>
    <d2p1:AgentCSZ>sample string 8</d2p1:AgentCSZ>
    <d2p1:AgentCode>sample string 5</d2p1:AgentCode>
    <d2p1:AgentName>sample string 6</d2p1:AgentName>
    <d2p1:AgentPhone>sample string 9</d2p1:AgentPhone>
    <d2p1:PolicyCollision>
      <d2p1:Amount>1</d2p1:Amount>
      <d2p1:Currency>UsDollar</d2p1:Currency>
    </d2p1:PolicyCollision>
    <d2p1:PolicyComprehensiveDeductible>
      <d2p1:Amount>1</d2p1:Amount>
      <d2p1:Currency>UsDollar</d2p1:Currency>
    </d2p1:PolicyComprehensiveDeductible>
    <d2p1:PolicyEffectiveDate>2025-04-28T13:54:48.8907283Z</d2p1:PolicyEffectiveDate>
    <d2p1:PolicyExpirationDate>2025-04-28T13:54:48.8907283Z</d2p1:PolicyExpirationDate>
    <d2p1:PolicyNumber>sample string 10</d2p1:PolicyNumber>
    <d2p1:VendorAddress>sample string 3</d2p1:VendorAddress>
    <d2p1:VendorCSZ>sample string 4</d2p1:VendorCSZ>
    <d2p1:VendorCode>sample string 1</d2p1:VendorCode>
    <d2p1:VendorName>sample string 2</d2p1:VendorName>
  </PhysicalDamageInsurance>
  <References>
    <CustomerKey>sample string 1</CustomerKey>
  </References>
  <Upsource>sample string 3</Upsource>
</Prospect>