LeadGen Consumer:Response

← LeadGen Cloud API

Return Elements

Returned for both get-count and buy-list requests:

XML Element	XML Description
<Consumer>	Tag encapsulating the whole XML document.
<Geography>	Geo request
<Address>	Requests within Geo Selects. Tags returned depend on Geo type.
<City>
<County>
<State>
<ZIP>
<Records>	Returned if Radius is called with &records specification.
<Miles>	Returned if Radius is called with &mile specification.
<Options>	Requested options.
<ContactPersonInfo>	Specific options tag within Demographic Selects.
<ContactPersonInfo>
<BuildingType>
<Details>
<HouseholdIncome>
<IncludeAll> OR <Details>	Depends on request options. Tags included from this tag to <TargetHomeValuationModelIn1000s> inclusive.
<AppendToFile>
<ContactAgeGroup>
<HomeOwnerRenter>
<MaritalStatus>
<LengthOfResidentCode>
<HouseholdAgeCode>
<Gender>
<NumPersonsInHousehold>
<NumAdultsInHousehold>
<NumChildrenInHousehold>
<HouseholdCreditCardInfo>
<MailResponsiveInfo>
<NetWorthModel>
<TargetHomeValuationModeIn1000s>
<AdditionalAppend>
<CountDetails>	Contains a breakdown of the total count.
<StreetRange>	Contains a breakdown of the street range.
<Street>	Individual streets.
<StartNumber>	For Geo types radius and street. Shows the starting street number and ending street number in the count.
<EndNumber>
<Geography>	Location of count detail. The location varies by the request type: ZIP type returns Zip plus 4. City type returns city, state. County type returns county, state. State type returns state. Street type returns street, city, state. Radius type returns street, city, state.
<Zip>	For radius and street types.
<Count>	Number of records that <StartNumber>, <EndNumber>, <Geography>, and <Zip> apply to.
<Addresses>	Returned with geo type Street. Only returned with Radius when strzip is specified. Contains a breakdown of the addresses returned.
<Address>	Individual addresses.
<TotalCount>	Total number of records returned with the selected options.
<Order>	Buy Requests Only. Order details for a Buy request.
<Id>	Order Id.
<Usage>
<DownloadURL>	The URL to download the purchased file.
<PONumber>	Returned if po is specified.
<DeliveredQty>
<RequestedQty>	Returned if &qty is specified.
<Result>	Returns the status code.
<StatusCode>	Indicates the status of the ID. Returns Declined, Approved, or Err. If Err is returned, see Result Codes for more information.

Examples

Get Call

http://list.melissadata.net/V1/Consumer/rest/Service.svc/get/radius?id=customer@domain.com&addr=22382 avenida empresa&zip=92688&records=100&dwell=2&hinc-d=1-3-5

XML Output

<Consumer>
  <Geography>
    <Address>22382 Avenida Empresa</Address>
    <City>Rancho Santa Margarita</City>
    <State>CA</State>
    <Zip>92688</Zip>
    <Records>100</Records>
  </Geography>
  <Options>
    <ContactPersonInfo>
      <ContactPersonInfo>One per Address</ContactPersonInfo>
    </ContactPersonInfo>
    <BuildingType>
      <Details>Single Family Only</Details>
    </BuildingType>
    <HouseholdIncome>
      <Details>$0 - 14,999;$20,000 - 29,999;$40,000 - 49,999</Details>
      <AppendToFile>False</AppendToFile>
    </HouseholdIncome>
    <ContactAgeGroup>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </ContactAgeGroup>
    <HomeOwnerRenter>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </HomeOwnerRenter>
    <MaritalStatus>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </MaritalStatus>
    <LengthOfResidentCode>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </LengthOfResidentCode>
    <HouseholdAgeCode>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </HouseholdAgeCode>
    <Gender>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </Gender>
    <NumPersonsInHousehold>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </NumPersonsInHousehold>
    <NumAdultsInHousehold>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </NumAdultsInHousehold>
    <NumChildrenInHousehold>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </NumChildrenInHousehold>
    <HouseholdCreditCardInfo>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </HouseholdCreditCardInfo>
    <MailResponsiveInfo>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </MailResponsiveInfo>
    <NetWorthModel>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </NetWorthModel>
    <TargetHomeValuationModeIn1000s>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </TargetHomeValuationModeIn1000s>
    <AdditionalAppend/>
  </Options>
  <CountDetails>
    <StreetRange>
      <Street>
        <StartNumber>60</StartNumber>
        <EndNumber>96</EndNumber>
        <Geography>ABRIGO , Rancho Santa Margarita CA</Geography>
        <Count>5</Count>
      </Street>
      ...
    </StreetRange>
    <TotalCount>
      <Count>100</Count>
    </TotalCount>
    <Result>
      <StatusCode>Approved</StatusCode>
    </Result>
  </CountDetails>
</Consumer>