Call us toll free @ 888-497-7898

listverify - getlists

Gets a list of all list verify jobs

API Call Information
area: listverify
action: getlists

API Arguments

Argument	Data Type	Required	Description
start	integer	No	Starting position
limit	integer	No	Number of records to return

API Url Example:
https://api.hypermail.com/api.php?apikey=YOURAPIKEYHERE&area=listverify&action=getlists

API Result:

XML Response

JSON Response

<response>
  <records>434</records>
  <list>
    <id>42869</id>
    <title><![CDATA[37413 - US contractor LI]]></title>
    <status>List Verified</status>
    <datecreated>June 12, 2024, 01:55 pm</datecreated>
    <total>16,268</total>
    <validrecords>10,141</validrecords>
    <creditsused>0</creditsused>
    <listverfieddate>June 12, 2024, 03:05 pm</listverfieddate>
    <catchall>5154</catchall>
    <baddomain>208</baddomain>
    <badmx>0</badmx>
    <parkingsite>0</parkingsite>
    <settingsrejected>0</settingsrejected>
    <suppressedrole>0</suppressedrole>
    <suppressedglobalbounce>0</suppressedglobalbounce>
    <suppresseddomain>0</suppresseddomain>
    <suppresseduser>0</suppresseduser>
    <suppressedspambots>0</suppressedspambots>
    <spamtrapserver>149</spamtrapserver>
    <domainriskyarecord>125</domainriskyarecord>
    <filesize>5MB</filesize>
  </list>
  <list>
    <id>42868</id>
    <title><![CDATA[37410 - US construction]]></title>
    <status>List Verified</status>
    <datecreated>June 12, 2024, 01:55 pm</datecreated>
    <total>440,574</total>
    <validrecords>287,447</validrecords>
    <creditsused>0</creditsused>
    <listverfieddate>June 13, 2024, 05:12 am</listverfieddate>
    <catchall>139416</catchall>
    <baddomain>2,205</baddomain>
    <badmx>0</badmx>
    <parkingsite>0</parkingsite>
    <settingsrejected>0</settingsrejected>
    <suppressedrole>0</suppressedrole>
    <suppressedglobalbounce>0</suppressedglobalbounce>
    <suppresseddomain>0</suppresseddomain>
    <suppresseduser>0</suppresseduser>
    <suppressedspambots>0</suppressedspambots>
    <spamtrapserver>2,182</spamtrapserver>
    <domainriskyarecord>3,180</domainriskyarecord>
    <filesize>139MB</filesize>
  </list>
  <list>
    <id>42867</id>
    <title><![CDATA[apollo-contacts-export(54).csv]]></title>
    <status>List Verified</status>
    <datecreated>June 12, 2024, 07:37 am</datecreated>
    <total>9,889</total>
    <validrecords>8,487</validrecords>
    <creditsused>0</creditsused>
    <listverfieddate>June 12, 2024, 08:04 am</listverfieddate>
    <catchall>544</catchall>
    <baddomain>317</baddomain>
    <badmx>0</badmx>
    <parkingsite>10</parkingsite>
    <settingsrejected>0</settingsrejected>
    <suppressedrole>1</suppressedrole>
    <suppressedglobalbounce>266</suppressedglobalbounce>
    <suppresseddomain>28</suppresseddomain>
    <suppresseduser>3</suppresseduser>
    <suppressedspambots>3</suppressedspambots>
    <spamtrapserver>52</spamtrapserver>
    <domainriskyarecord>137</domainriskyarecord>
    <filesize>9MB</filesize>
  </list>
  <list>
    <id>42866</id>
    <title><![CDATA[apollo-contacts-export(53).csv]]></title>
    <status>List Verified</status>
    <datecreated>June 12, 2024, 12:11 am</datecreated>
    <total>9,889</total>
    <validrecords>8,489</validrecords>
    <creditsused>0</creditsused>
    <listverfieddate>June 12, 2024, 12:50 am</listverfieddate>
    <catchall>544</catchall>
    <baddomain>317</baddomain>
    <badmx>0</badmx>
    <parkingsite>10</parkingsite>
    <settingsrejected>0</settingsrejected>
    <suppressedrole>1</suppressedrole>
    <suppressedglobalbounce>172</suppressedglobalbounce>
    <suppresseddomain>28</suppresseddomain>
    <suppresseduser>2</suppresseduser>
    <suppressedspambots>3</suppressedspambots>
    <spamtrapserver>54</spamtrapserver>
    <domainriskyarecord>136</domainriskyarecord>
    <filesize>9MB</filesize>
  </list>
</response>

{
    "records": "434",
    "list": [
        {
            "id": "42869",
            "title": "37413 - US contractor LI",
            "status": "List Verified",
            "datecreated": "June 12, 2024, 01:55 pm",
            "total": "16,268",
            "validrecords": "10,141",
            "creditsused": "0",
            "listverfieddate": "June 12, 2024, 03:05 pm",
            "catchall": "5154",
            "baddomain": "208",
            "badmx": "0",
            "parkingsite": "0",
            "settingsrejected": "0",
            "suppressedrole": "0",
            "suppressedglobalbounce": "0",
            "suppresseddomain": "0",
            "suppresseduser": "0",
            "suppressedspambots": "0",
            "spamtrapserver": "149",
            "domainriskyarecord": "125",
            "filesize": "5MB"
        },
        {
            "id": "42868",
            "title": "37410 - US construction",
            "status": "List Verified",
            "datecreated": "June 12, 2024, 01:55 pm",
            "total": "440,574",
            "validrecords": "287,447",
            "creditsused": "0",
            "listverfieddate": "June 13, 2024, 05:12 am",
            "catchall": "139416",
            "baddomain": "2,205",
            "badmx": "0",
            "parkingsite": "0",
            "settingsrejected": "0",
            "suppressedrole": "0",
            "suppressedglobalbounce": "0",
            "suppresseddomain": "0",
            "suppresseduser": "0",
            "suppressedspambots": "0",
            "spamtrapserver": "2,182",
            "domainriskyarecord": "3,180",
            "filesize": "139MB"
        },
        {
            "id": "42867",
            "title": "apollo-contacts-export(54).csv",
            "status": "List Verified",
            "datecreated": "June 12, 2024, 07:37 am",
            "total": "9,889",
            "validrecords": "8,487",
            "creditsused": "0",
            "listverfieddate": "June 12, 2024, 08:04 am",
            "catchall": "544",
            "baddomain": "317",
            "badmx": "0",
            "parkingsite": "10",
            "settingsrejected": "0",
            "suppressedrole": "1",
            "suppressedglobalbounce": "266",
            "suppresseddomain": "28",
            "suppresseduser": "3",
            "suppressedspambots": "3",
            "spamtrapserver": "52",
            "domainriskyarecord": "137",
            "filesize": "9MB"
        },
        {
            "id": "42866",
            "title": "apollo-contacts-export(53).csv",
            "status": "List Verified",
            "datecreated": "June 12, 2024, 12:11 am",
            "total": "9,889",
            "validrecords": "8,489",
            "creditsused": "0",
            "listverfieddate": "June 12, 2024, 12:50 am",
            "catchall": "544",
            "baddomain": "317",
            "badmx": "0",
            "parkingsite": "10",
            "settingsrejected": "0",
            "suppressedrole": "1",
            "suppressedglobalbounce": "172",
            "suppresseddomain": "28",
            "suppresseduser": "2",
            "suppressedspambots": "3",
            "spamtrapserver": "54",
            "domainriskyarecord": "136",
            "filesize": "9MB"
        }
    ]
}