Job Status and Download API

The Job Status API will provide a JSON response containing status of the processing list.

Format

API End point: https://api.versium.com/v2/jobs/<job-id>

HTTP method: GET

Response Structure
Content-type: application/json

Processing response:

{
    "versium": {
        "version": "2.0",
        "query_id": "98f3c1b39419dd6165a83069ffb1cb0b",
        "query_time": 0.14180994033813477,
        "results": {
            "id": 810271,
            "guid": "d49747d6-3953-4c35-9d9f-e413f33f2224",
            "state": "processing",
            "operation": "personaListGen",
            "created_at": "2024-05-24T20:52:11.000000Z",
            "finished_at": null,
            "config": {
                "cfg_groupby": "emailAddr",
                "d_city_state": [
                    "Redmond, wa"
                ],
                "listgen_output_option": [
                    "oa"
                ]
            },
            "output_list": {
                "id": 636865,
                "download_url": null,
                "num_matches": 0,
                "num_records": 0,
                "project_id": 80370,
                "insights": null
            },
            "state_url": "https://api.versium.com/v2/jobs/810271",
            "callback_url": null,
            "suppression_input_list_ids": null,
            "est_sec_remaining": 565,
            "progress_percentage": 29
        }
    }
}

Completed job:

Once the job is completed, the response will contain the "state":"Done" string. The response will also contain the following:

  • download URL - the url that can be used to download the generated list in CSV format.
  • number of matches in the list
  • number of records in the list
  • insights - a set of data containing the insights of the generated list
{
    "versium": {
        "version": "2.0",
        "query_id": "10eee2261c1caf96a1ee4ddff9b506ff",
        "query_time": 0.15358805656433105,
        "results": {
            "id": 810271,
            "guid": "d49747d6-3953-4c35-9d9f-e413f33f2224",
            "state": "done",
            "operation": "personaListGen",
            "created_at": "2024-05-24T20:52:11.000000Z",
            "finished_at": "2024-05-24 21:00:53",
            "config": {
                "cfg_groupby": "emailAddr",
                "d_city_state": [
                    "Redmond, wa"
                ],
                "listgen_output_option": [
                    "oa"
                ]
            },
            "output_list": {
                "id": 636865,
                "download_url": "https://api.versium.com/v2/lists/636865/download",
                "num_matches": 79656,
                "num_records": 79656,
                "project_id": 80370,
                "insights": {
                    "Age": {
                        "data": [
                            [
                                "18-24",
                                0
                            ],
                            [
                                "25-34",
                                0
                            ],
                            [
                                "35-44",
                                0
                            ],
                            [
                                "45-54",
                                0
                            ],
                            [
                                "55-64",
                                0
                            ],
                            [
                                "65-74",
                                0
                            ],
                            [
                                "75 +",
                                0
                            ]
                        ],
                        "fillRate": 0,
                        "highestValue": [
                            "",
                            0
                        ]
                    },
                    "Gender": {
                        "data": [
                            [
                                "M",
                                0
                            ],
                            [
                                "F",
                                0
                            ]
                        ],
                        "fillRate": 0,
                        "highestValue": [
                            "",
                            0
                        ]
                    },
                    "Income": {
                        "data": [
                            [
                                "< 50,000",
                                0
                            ],
                            [
                                "50,000-149,000",
                                0
                            ],
                            [
                                "150,000-249,000",
                                0
                            ],
                            [
                                "250,000 +",
                                0
                            ]
                        ],
                        "fillRate": 0,
                        "highestValue": [
                            "",
                            0
                        ]
                    },
                    "Titles": {
                        "data": [
                            [
                                "STUDENT",
                                14.6
                            ],
                            [
                                "CASHIER",
                                6.1
                            ],
                            [
                                "MANAGER",
                                4.4
                            ],
                            [
                                "CREW MEMBER",
                                3.8
                            ],
                            [
                                "OWNER",
                                2.7
                            ],
                            [
                                "ASSISTANT MANAGER",
                                2.1
                            ],
                            [
                                "SOFTWARE ENGINEER",
                                1.9
                            ],
                            [
                                "COOK",
                                1.9
                            ],
                            [
                                "GENERAL MANAGER",
                                1.7
                            ],
                            [
                                "PRESIDENT",
                                1.5
                            ],
                            [
                                "TEACHER",
                                1.5
                            ],
                            [
                                "SHIFT LEAD",
                                1.5
                            ],
                            [
                                "NONE",
                                1.3
                            ],
                            [
                                "ATTORNEY",
                                1
                            ],
                            [
                                "PROGRAM MANAGER",
                                1
                            ],
                            [
                                "PROJECT MANAGER",
                                1
                            ],
                            [
                                "*******",
                                1
                            ],
                            [
                                "SUPERVISOR",
                                0.8
                            ],
                            [
                                "FOOD SERVICE WORKER",
                                0.8
                            ],
                            [
                                "SHIFT MANAGER",
                                0.8
                            ],
                            [
                                "DAIRY QUEEN",
                                0.8
                            ],
                            [
                                "OFFICE MANAGER",
                                0.6
                            ],
                            [
                                "PRINCIPAL",
                                0.6
                            ],
                            [
                                "SENIOR SOFTWARE ENGINEER",
                                0.6
                            ],
                            [
                                "SOFTWARE DEVELOPER",
                                0.6
                            ],
                            [
                                "DIRECTOR",
                                0.6
                            ],
                            [
                                "UNEMPLOYED",
                                0.6
                            ],
                            [
                                "VICE PRESIDENT",
                                0.6
                            ],
                            [
                                "ACCOUNT MANAGER",
                                0.6
                            ],
                            [
                                "ADMINISTRATIVE ASSISTANT",
                                0.6
                            ],
                            [
                                "MEMBER",
                                0.6
                            ],
                            [
                                "CUSTOMER SERVICE REPRESENTATIVE",
                                0.6
                            ],
                            [
                                "CUSTOMER SERVICE",
                                0.6
                            ],
                            [
                                "TEAM MEMBER",
                                0.6
                            ],
                            [
                                "EMPLOYEE",
                                0.6
                            ],
                            [
                                "SHIFT LEADER",
                                0.6
                            ],
                            [
                                "SALES",
                                0.4
                            ],
                            [
                                "PRODUCT MANAGER",
                                0.4
                            ],
                            [
                                "CHIEF EXECUTIVE OFFICER",
                                0.4
                            ],
                            [
                                "CEO",
                                0.4
                            ],
                            [
                                "ENGINEER",
                                0.4
                            ],
                            [
                                "SALES MANAGER",
                                0.4
                            ],
                            [
                                "TEST",
                                0.4
                            ],
                            [
                                "ACCOUNT EXECUTIVE",
                                0.4
                            ],
                            [
                                "BUSINESS OWNER",
                                0.4
                            ],
                            [
                                "SALES ASSOCIATE",
                                0.4
                            ],
                            [
                                "PARTNER",
                                0.4
                            ],
                            [
                                "SERVER",
                                0.4
                            ],
                            [
                                "FOOD SERVER",
                                0.4
                            ],
                            [
                                "CONSULTANT",
                                0.4
                            ],
                            [
                                "ASSOCIATE",
                                0.4
                            ],
                            [
                                "CASHIER CUSTOMER SERVICE",
                                0.4
                            ],
                            [
                                "SHIFT SUPERVISOR",
                                0.4
                            ],
                            [
                                "GRILL COOK",
                                0.4
                            ],
                            [
                                "FAST FOOD COOK",
                                0.4
                            ],
                            [
                                "INSURANCE AGENT",
                                0.2
                            ],
                            [
                                "AGENT",
                                0.2
                            ],
                            [
                                "TECHNICIAN",
                                0.2
                            ],
                            [
                                "BUSINESS DEVELOPMENT MANAGER",
                                0.2
                            ],
                            [
                                "PROJECT COORDINATOR",
                                0.2
                            ],
                            [
                                "REGIONAL SALES MANAGER",
                                0.2
                            ],
                            [
                                "SALES SPECIALIST",
                                0.2
                            ],
                            [
                                "TECHNICAL ACCOUNT MANAGER",
                                0.2
                            ],
                            [
                                "SENIOR ACCOUNTANT",
                                0.2
                            ],
                            [
                                "TECHNICAL RECRUITER",
                                0.2
                            ],
                            [
                                "PARTNER ACCOUNT MANAGER",
                                0.2
                            ],
                            [
                                "BUSINESS ANALYST",
                                0.2
                            ],
                            [
                                "SENIOR PRODUCT MANAGER",
                                0.2
                            ],
                            [
                                "ACCOUNTANT",
                                0.2
                            ],
                            [
                                "REALTOR",
                                0.2
                            ],
                            [
                                "RECRUITER",
                                0.2
                            ],
                            [
                                "ACCOUNTING MANAGER",
                                0.2
                            ],
                            [
                                "DIRECTOR OF OPERATIONS",
                                0.2
                            ],
                            [
                                "CHIEF FINANCIAL OFFICER",
                                0.2
                            ],
                            [
                                "BOARD MEMBER",
                                0.2
                            ],
                            [
                                "SOFTWARE DEVELOPMENT ENGINEER",
                                0.2
                            ],
                            [
                                "SOFTWARE ENGINEER 2",
                                0.2
                            ],
                            [
                                "MUSIC TEACHER",
                                0.2
                            ],
                            [
                                "DATA ANALYST",
                                0.2
                            ],
                            [
                                "TEST ENGINEER",
                                0.2
                            ],
                            [
                                "SENIOR PROJECT MANAGER",
                                0.2
                            ],
                            [
                                "OTHER",
                                0.2
                            ],
                            [
                                "MARKETING",
                                0.2
                            ],
                            [
                                "******",
                                0.2
                            ],
                            [
                                "INSTRUCTOR",
                                0.2
                            ],
                            [
                                "***",
                                0.2
                            ],
                            [
                                "FOUNDER",
                                0.2
                            ],
                            [
                                "GRADUATE STUDENT",
                                0.2
                            ],
                            [
                                "NETWORK ENGINEER",
                                0.2
                            ],
                            [
                                "*********",
                                0.2
                            ],
                            [
                                "SUPERVISING AGENT",
                                0.2
                            ],
                            [
                                "BUSINESS MANAGER",
                                0.2
                            ],
                            [
                                "MACHINE OPERATOR",
                                0.2
                            ],
                            [
                                "INFORMATION TECHNOLOGY",
                                0.2
                            ],
                            [
                                "BUSINESS CONSULTANT",
                                0.2
                            ],
                            [
                                "TECHNICAL PROGRAM MANAGER",
                                0.2
                            ],
                            [
                                "GRAPHIC DESIGNER",
                                0.2
                            ],
                            [
                                "TEAM LEAD",
                                0.2
                            ],
                            [
                                "REGISTERED NURSE",
                                0.2
                            ],
                            [
                                "CHIEF TECHNOLOGY OFFICER",
                                0.2
                            ]
                        ],
                        "fillRate": 99.99246770528642,
                        "highestValue": [
                            "STUDENT",
                            14.6
                        ]
                    },
                    "Revenue": {
                        "data": [
                            [
                                "< 10,000,000",
                                42
                            ],
                            [
                                "10,000,000-50,000,000",
                                5.3
                            ],
                            [
                                "50,000,000-100,000,000",
                                3.2
                            ],
                            [
                                "100,000,000-500,000,000",
                                5.6
                            ],
                            [
                                "500,000,000-1,000,000,000",
                                1
                            ],
                            [
                                "1,000,000,000-10,000,000,000",
                                0.3
                            ],
                            [
                                "10,000,000,000 +",
                                42.6
                            ]
                        ],
                        "fillRate": 87.97469148976236,
                        "highestValue": [
                            "10,000,000,000 +",
                            42.6
                        ]
                    },
                    "Industry": {
                        "data": [
                            [
                                "Business Services (Software, Programming, IT)",
                                44.7
                            ],
                            [
                                "Mortgage",
                                23.5
                            ],
                            [
                                "Elementary and Secondary Schools",
                                5.1
                            ],
                            [
                                "Colleges, Universities, and Professional Schools",
                                2.6
                            ],
                            [
                                "Social Services",
                                1.7
                            ],
                            [
                                "Government Executive",
                                1.6
                            ],
                            [
                                "Electronics and Electronic Components",
                                1.4
                            ],
                            [
                                "Engineering, Architectural, And Surveying",
                                1.3
                            ],
                            [
                                "Construction (Special Trade)",
                                1.2
                            ],
                            [
                                "Insurance and Casualty",
                                1.2
                            ],
                            [
                                "Food Products (Miscellaneous)",
                                1.1
                            ],
                            [
                                "Computer And Office Equipment",
                                0.8
                            ],
                            [
                                "Junior Colleges and Technical Institutes",
                                0.8
                            ],
                            [
                                "Miscellaneous Non-durable Goods",
                                0.7
                            ],
                            [
                                "Manufactured Goods (Games, Toys)",
                                0.6
                            ],
                            [
                                "Services (Miscellaneous)",
                                0.5
                            ],
                            [
                                "Electrical Equipment and Appliances",
                                0.5
                            ],
                            [
                                "Medical / Dental Devices and Supplies",
                                0.5
                            ],
                            [
                                "International Affairs",
                                0.4
                            ],
                            [
                                "Health Services (Medical Clinics)",
                                0.4
                            ],
                            [
                                "Services (Amusement and Recreation)",
                                0.4
                            ],
                            [
                                "Business Services (Miscellaneous)",
                                0.4
                            ],
                            [
                                "Media and Broadcast",
                                0.4
                            ],
                            [
                                "Retail (Apparel)",
                                0.4
                            ],
                            [
                                "Construction (Building/Contractor)",
                                0.3
                            ],
                            [
                                "Business Services (Staffing/Personnel)",
                                0.3
                            ],
                            [
                                "Communications and Telecom",
                                0.3
                            ],
                            [
                                "Industrial and Commercial Machinery",
                                0.3
                            ],
                            [
                                "Legal Services",
                                0.3
                            ],
                            [
                                "Religious Organizations",
                                0.3
                            ],
                            [
                                "Health Services (Miscellaneous)",
                                0.2
                            ],
                            [
                                "Real Estate (Agents/Brokers)",
                                0.2
                            ],
                            [
                                "Laboratory Equipment and Measurement Devices",
                                0.2
                            ],
                            [
                                "Management Consulting Services",
                                0.2
                            ],
                            [
                                "Real Estate (Management)",
                                0.2
                            ],
                            [
                                "Retail (Miscellaneous)",
                                0.2
                            ],
                            [
                                "Accounting and Bookkeeping",
                                0.2
                            ],
                            [
                                "Business Consulting (Miscellaneous)",
                                0.2
                            ],
                            [
                                "Research (Economic, Sociological, and Education)",
                                0.2
                            ],
                            [
                                "Business Services (Photography and Graphic Arts)",
                                0.2
                            ],
                            [
                                "Banks and Depository Institutions",
                                0.2
                            ],
                            [
                                "Retail (Motor Vehicle)",
                                0.2
                            ],
                            [
                                "Chemicals (Miscellaneous)",
                                0.2
                            ],
                            [
                                "Business Services (Clerical)",
                                0.2
                            ],
                            [
                                "Securities and Commodities",
                                0.1
                            ],
                            [
                                "Eductional Services (Miscellaneous)",
                                0.1
                            ],
                            [
                                "Commercial Equipment and Supplies",
                                0.1
                            ],
                            [
                                "Retail (Book, Media)",
                                0.1
                            ],
                            [
                                "Health Services (Dental Clinics)",
                                0.1
                            ],
                            [
                                "Metal (Foundaries, Mills, Refining, Processing)",
                                0.1
                            ],
                            [
                                "Metal (Fabricated Products)",
                                0.1
                            ],
                            [
                                "Transportation (Air Cargo, Charter and Courier)",
                                0.1
                            ],
                            [
                                "Manufactured Goods (Miscellaneous)",
                                0.1
                            ],
                            [
                                "Retail (Grocery/Food/Liquor)",
                                0.1
                            ],
                            [
                                "Retail (Department and General)",
                                0.1
                            ],
                            [
                                "Food Products (Beverage/Wine/Spirit)",
                                0.1
                            ],
                            [
                                "Business Services (Advertising)",
                                0.1
                            ],
                            [
                                "Services (Personal Care)",
                                0.1
                            ],
                            [
                                "Eating And Drinking Places",
                                0.1
                            ],
                            [
                                "Construction and Building Materials",
                                0.1
                            ],
                            [
                                "Motor Freight and Warehousing",
                                0.1
                            ],
                            [
                                "Landscape Services",
                                0.1
                            ],
                            [
                                "Food Products (Meat/Dairy/Seafood)",
                                0.1
                            ],
                            [
                                "Printing",
                                0.1
                            ],
                            [
                                "Retail (Appliance, Electronic, Computer)",
                                0.1
                            ],
                            [
                                "Retail (Home Furnishing)",
                                0.1
                            ],
                            [
                                "Public Relations Services",
                                0.1
                            ],
                            [
                                "Health Services (Home Care)",
                                0.1
                            ],
                            [
                                "Civic, Social, And Fraternal Associations",
                                0.1
                            ],
                            [
                                "Navigation Equipment",
                                0.1
                            ],
                            [
                                "Chemicals (Paint, Ink, Adhesive)",
                                0.1
                            ],
                            [
                                "Publishing",
                                0.1
                            ],
                            [
                                "Stone, Clay, Glass, And Concrete Products",
                                0.1
                            ],
                            [
                                "Motion Picture",
                                0.1
                            ]
                        ],
                        "fillRate": 89.85148825589717,
                        "highestValue": [
                            "Business Services (Software, Programming, IT)",
                            44.7
                        ]
                    },
                    "AgeGender": {
                        "data": [
                            {
                                "F": 0,
                                "M": 0,
                                "AgeRange": "18-24"
                            },
                            {
                                "F": 0,
                                "M": 0,
                                "AgeRange": "25-34"
                            },
                            {
                                "F": 0,
                                "M": 0,
                                "AgeRange": "35-44"
                            },
                            {
                                "F": 0,
                                "M": 0,
                                "AgeRange": "45-54"
                            },
                            {
                                "F": 0,
                                "M": 0,
                                "AgeRange": "55-64"
                            },
                            {
                                "F": 0,
                                "M": 0,
                                "AgeRange": "65-74"
                            },
                            {
                                "F": 0,
                                "M": 0,
                                "AgeRange": "75 +"
                            }
                        ],
                        "fillRate": 0,
                        "highestValue": [
                            "",
                            0
                        ]
                    },
                    "Education": {
                        "data": [
                            [
                                "Completed High School",
                                0
                            ],
                            [
                                "Tech/Vocational Training",
                                0
                            ],
                            [
                                "Completed College",
                                0
                            ],
                            [
                                "Completed Grad School",
                                0
                            ]
                        ],
                        "fillRate": 0,
                        "highestValue": [
                            "",
                            0
                        ]
                    },
                    "Ethnicity": {
                        "data": [],
                        "fillRate": 0,
                        "highestValue": [
                            "Asian",
                            0
                        ]
                    },
                    "TitleRank": {
                        "data": [],
                        "fillRate": 0,
                        "highestValue": [
                            "chief",
                            0
                        ]
                    },
                    "SICAndText": {
                        "data": [
                            [
                                "7372 - Business Services (Software, Programming, IT)",
                                42.1
                            ],
                            [
                                "6162 - Mortgage",
                                23.6
                            ],
                            [
                                "8211 - Elementary and Secondary Schools",
                                5.1
                            ],
                            [
                                "8221 - Colleges, Universities, and Professional Schools",
                                2.6
                            ],
                            [
                                "7371 - Business Services (Software, Programming, IT)",
                                1.9
                            ],
                            [
                                "8322 - Social Services",
                                1.7
                            ],
                            [
                                "8711 - Engineering, Architectural, And Surveying",
                                1.2
                            ],
                            [
                                "6311 - Insurance and Casualty",
                                1.1
                            ],
                            [
                                "5149 - Food Products (Miscellaneous)",
                                1.1
                            ],
                            [
                                "9111 - Government Executive",
                                0.9
                            ],
                            [
                                "7373 - Business Services (Software, Programming, IT)",
                                0.8
                            ],
                            [
                                "8222 - Junior Colleges and Technical Institutes",
                                0.8
                            ],
                            [
                                "9199 - Government Executive",
                                0.8
                            ],
                            [
                                "5199 - Miscellaneous Non-durable Goods",
                                0.7
                            ],
                            [
                                "5045 - Computer And Office Equipment",
                                0.6
                            ],
                            [
                                "7299 - Services (Miscellaneous)",
                                0.5
                            ],
                            [
                                "3651 - Electronics and Electronic Components",
                                0.5
                            ],
                            [
                                "3674 - Electronics and Electronic Components",
                                0.5
                            ],
                            [
                                "5092 - Manufactured Goods (Games, Toys)",
                                0.5
                            ],
                            [
                                "9999 - International Affairs",
                                0.4
                            ],
                            [
                                "7389 - Business Services (Miscellaneous)",
                                0.4
                            ],
                            [
                                "1731 - Construction (Special Trade)",
                                0.4
                            ],
                            [
                                "5699 - Retail (Apparel)",
                                0.4
                            ],
                            [
                                "3841 - Medical / Dental Devices and Supplies",
                                0.4
                            ],
                            [
                                "5065 - Electrical Equipment and Appliances",
                                0.3
                            ],
                            [
                                "8111 - Legal Services",
                                0.3
                            ],
                            [
                                "8661 - Religious Organizations",
                                0.3
                            ],
                            [
                                "4841 - Media and Broadcast",
                                0.3
                            ],
                            [
                                "3679 - Electronics and Electronic Components",
                                0.3
                            ],
                            [
                                "1711 - Construction (Special Trade)",
                                0.2
                            ],
                            [
                                "1521 - Construction (Building/Contractor)",
                                0.2
                            ],
                            [
                                "7361 - Business Services (Staffing/Personnel)",
                                0.2
                            ],
                            [
                                "8099 - Health Services (Miscellaneous)",
                                0.2
                            ],
                            [
                                "6531 - Real Estate (Agents/Brokers)",
                                0.2
                            ],
                            [
                                "4813 - Communications and Telecom",
                                0.2
                            ],
                            [
                                "8742 - Management Consulting Services",
                                0.2
                            ],
                            [
                                "6513 - Real Estate (Management)",
                                0.2
                            ],
                            [
                                "7991 - Services (Amusement and Recreation)",
                                0.2
                            ],
                            [
                                "8721 - Accounting and Bookkeeping",
                                0.2
                            ],
                            [
                                "8011 - Health Services (Medical Clinics)",
                                0.2
                            ],
                            [
                                "8748 - Business Consulting (Miscellaneous)",
                                0.2
                            ],
                            [
                                "1752 - Construction (Special Trade)",
                                0.2
                            ],
                            [
                                "8732 - Research (Economic, Sociological, and Education)",
                                0.2
                            ],
                            [
                                "7336 - Business Services (Photography and Graphic Arts)",
                                0.2
                            ],
                            [
                                "5511 - Retail (Motor Vehicle)",
                                0.2
                            ],
                            [
                                "6061 - Banks and Depository Institutions",
                                0.2
                            ],
                            [
                                "5169 - Chemicals (Miscellaneous)",
                                0.2
                            ],
                            [
                                "7338 - Business Services (Clerical)",
                                0.2
                            ],
                            [
                                "6282 - Securities and Commodities",
                                0.1
                            ],
                            [
                                "8712 - Engineering, Architectural, And Surveying",
                                0.1
                            ],
                            [
                                "8299 - Eductional Services (Miscellaneous)",
                                0.1
                            ],
                            [
                                "5049 - Commercial Equipment and Supplies",
                                0.1
                            ],
                            [
                                "5942 - Retail (Book, Media)",
                                0.1
                            ],
                            [
                                "7379 - Business Services (Software, Programming, IT)",
                                0.1
                            ],
                            [
                                "8021 - Health Services (Dental Clinics)",
                                0.1
                            ],
                            [
                                "5063 - Electrical Equipment and Appliances",
                                0.1
                            ],
                            [
                                "3822 - Laboratory Equipment and Measurement Devices",
                                0.1
                            ],
                            [
                                "1791 - Construction (Special Trade)",
                                0.1
                            ],
                            [
                                "3559 - Industrial and Commercial Machinery",
                                0.1
                            ],
                            [
                                "5499 - Retail (Grocery/Food/Liquor)",
                                0.1
                            ],
                            [
                                "5399 - Retail (Department and General)",
                                0.1
                            ],
                            [
                                "3577 - Computer And Office Equipment",
                                0.1
                            ],
                            [
                                "2084 - Food Products (Beverage/Wine/Spirit)",
                                0.1
                            ],
                            [
                                "4899 - Media and Broadcast",
                                0.1
                            ],
                            [
                                "7231 - Services (Personal Care)",
                                0.1
                            ],
                            [
                                "5461 - Retail (Grocery/Food/Liquor)",
                                0.1
                            ],
                            [
                                "5047 - Medical / Dental Devices and Supplies",
                                0.1
                            ],
                            [
                                "4812 - Communications and Telecom",
                                0.1
                            ],
                            [
                                "5812 - Eating And Drinking Places",
                                0.1
                            ],
                            [
                                "6411 - Insurance and Casualty",
                                0.1
                            ],
                            [
                                "6163 - Mortgage",
                                0.1
                            ],
                            [
                                "5193 - Miscellaneous Non-durable Goods",
                                0.1
                            ],
                            [
                                "5999 - Retail (Miscellaneous)",
                                0.1
                            ],
                            [
                                "4731 - Transportation (Air Cargo, Charter and Courier)",
                                0.1
                            ],
                            [
                                "2752 - Printing",
                                0.1
                            ],
                            [
                                "5734 - Retail (Appliance, Electronic, Computer)",
                                0.1
                            ],
                            [
                                "7374 - Business Services (Software, Programming, IT)",
                                0.1
                            ],
                            [
                                "5712 - Retail (Home Furnishing)",
                                0.1
                            ],
                            [
                                "3825 - Laboratory Equipment and Measurement Devices",
                                0.1
                            ],
                            [
                                "1721 - Construction (Special Trade)",
                                0.1
                            ],
                            [
                                "8743 - Public Relations Services",
                                0.1
                            ],
                            [
                                "3571 - Computer And Office Equipment",
                                0.1
                            ],
                            [
                                "8042 - Health Services (Medical Clinics)",
                                0.1
                            ],
                            [
                                "7997 - Services (Amusement and Recreation)",
                                0.1
                            ],
                            [
                                "3531 - Industrial and Commercial Machinery",
                                0.1
                            ],
                            [
                                "8049 - Health Services (Medical Clinics)",
                                0.1
                            ],
                            [
                                "0782 - Landscape Services",
                                0.1
                            ],
                            [
                                "8082 - Health Services (Home Care)",
                                0.1
                            ],
                            [
                                "7992 - Services (Amusement and Recreation)",
                                0.1
                            ],
                            [
                                "5046 - Commercial Equipment and Supplies",
                                0.1
                            ],
                            [
                                "3523 - Industrial and Commercial Machinery",
                                0.1
                            ],
                            [
                                "8641 - Civic, Social, And Fraternal Associations",
                                0.1
                            ],
                            [
                                "3812 - Navigation Equipment",
                                0.1
                            ],
                            [
                                "3826 - Laboratory Equipment and Measurement Devices",
                                0.1
                            ],
                            [
                                "5198 - Chemicals (Paint, Ink, Adhesive)",
                                0.1
                            ],
                            [
                                "2741 - Publishing",
                                0.1
                            ],
                            [
                                "3299 - Stone, Clay, Glass, And Concrete Products",
                                0.1
                            ],
                            [
                                "3661 - Electronics and Electronic Components",
                                0.1
                            ],
                            [
                                "7812 - Motion Picture",
                                0.1
                            ],
                            [
                                "1743 - Construction (Special Trade)",
                                0.1
                            ]
                        ],
                        "fillRate": 89.85148825589717,
                        "highestValue": [
                            "7372 - Business Services (Software, Programming, IT)",
                            42.1
                        ]
                    },
                    "TitleRank2": {
                        "data": [
                            [
                                "Unclassified Management Titles",
                                32.7
                            ],
                            [
                                "Software Development - Engineering",
                                10.6
                            ],
                            [
                                "Sales & Business Development",
                                8.8
                            ],
                            [
                                "Educators",
                                5.9
                            ],
                            [
                                "Food - Restaurant",
                                5
                            ],
                            [
                                "Project Management",
                                4.6
                            ],
                            [
                                "Marketing",
                                4.1
                            ],
                            [
                                "Finance and Accounting",
                                2.9
                            ],
                            [
                                "Human Resources - HR",
                                2.8
                            ],
                            [
                                "Medical",
                                2.4
                            ],
                            [
                                "Administrative Assistants",
                                2.2
                            ],
                            [
                                "Information Technology - IT",
                                2.1
                            ],
                            [
                                "Customer Service - CSR",
                                2
                            ],
                            [
                                "Creative",
                                1.9
                            ],
                            [
                                "Legal",
                                1.6
                            ],
                            [
                                "Scientists",
                                1.5
                            ],
                            [
                                "Product Management",
                                1.2
                            ],
                            [
                                "Supply Chain and Procurement",
                                1.2
                            ],
                            [
                                "Accountants",
                                0.8
                            ],
                            [
                                "Banking",
                                0.8
                            ],
                            [
                                "Construction & Trades",
                                0.7
                            ],
                            [
                                "Media & Entertainment",
                                0.7
                            ],
                            [
                                "Personal Care",
                                0.5
                            ],
                            [
                                "Public Safety",
                                0.5
                            ],
                            [
                                "Business and Data Analysts",
                                0.4
                            ],
                            [
                                "Insurance",
                                0.4
                            ],
                            [
                                "Property and Facilities",
                                0.4
                            ],
                            [
                                "Real Estate",
                                0.4
                            ],
                            [
                                "UI & UX",
                                0.4
                            ],
                            [
                                "Engineering",
                                0.3
                            ],
                            [
                                "Dental",
                                0.2
                            ],
                            [
                                "Financial Planning - Advisors",
                                0.1
                            ],
                            [
                                "Risk Management - Fraud",
                                0.1
                            ]
                        ],
                        "fillRate": 57.716208242841184,
                        "highestValue": [
                            "Unclassified Management Titles",
                            32.7
                        ]
                    },
                    "B2BLocation": {
                        "data": [
                            [
                                "AL",
                                0.6
                            ],
                            [
                                "AK",
                                0.2
                            ],
                            [
                                "AZ",
                                1.3
                            ],
                            [
                                "AR",
                                0.4
                            ],
                            [
                                "CA",
                                6.7
                            ],
                            [
                                "CO",
                                1
                            ],
                            [
                                "CT",
                                0.4
                            ],
                            [
                                "DE",
                                0.2
                            ],
                            [
                                "DC",
                                0.3
                            ],
                            [
                                "FL",
                                2.6
                            ],
                            [
                                "GA",
                                2
                            ],
                            [
                                "HI",
                                0.2
                            ],
                            [
                                "ID",
                                0.4
                            ],
                            [
                                "IL",
                                2.1
                            ],
                            [
                                "IN",
                                1.5
                            ],
                            [
                                "IA",
                                0.5
                            ],
                            [
                                "KS",
                                0.6
                            ],
                            [
                                "KY",
                                1.1
                            ],
                            [
                                "LA",
                                0.6
                            ],
                            [
                                "ME",
                                0.2
                            ],
                            [
                                "MD",
                                0.6
                            ],
                            [
                                "MA",
                                2.7
                            ],
                            [
                                "MI",
                                1.1
                            ],
                            [
                                "MN",
                                2.7
                            ],
                            [
                                "MS",
                                0.5
                            ],
                            [
                                "MO",
                                0.8
                            ],
                            [
                                "MT",
                                0.3
                            ],
                            [
                                "NE",
                                0.3
                            ],
                            [
                                "NV",
                                0.6
                            ],
                            [
                                "NH",
                                0.1
                            ],
                            [
                                "NJ",
                                1
                            ],
                            [
                                "NM",
                                0.2
                            ],
                            [
                                "NY",
                                1.9
                            ],
                            [
                                "NC",
                                1.3
                            ],
                            [
                                "ND",
                                0.3
                            ],
                            [
                                "OH",
                                2.1
                            ],
                            [
                                "OK",
                                0.4
                            ],
                            [
                                "OR",
                                2
                            ],
                            [
                                "PA",
                                1.6
                            ],
                            [
                                "RI",
                                0.1
                            ],
                            [
                                "SC",
                                0.3
                            ],
                            [
                                "SD",
                                0.2
                            ],
                            [
                                "TN",
                                1.1
                            ],
                            [
                                "TX",
                                5.9
                            ],
                            [
                                "UT",
                                0.4
                            ],
                            [
                                "VA",
                                1.2
                            ],
                            [
                                "WA",
                                45.7
                            ],
                            [
                                "WV",
                                0.4
                            ],
                            [
                                "WI",
                                1.2
                            ],
                            [
                                "WY",
                                0.1
                            ]
                        ],
                        "fillRate": 41.221738202543406,
                        "highestValue": [
                            "WA",
                            45.7
                        ]
                    },
                    "B2CLocation": {
                        "data": [],
                        "fillRate": 0,
                        "highestValue": [
                            "",
                            0
                        ]
                    },
                    "CompanyType": {
                        "data": [
                            [
                                "Public",
                                38.1
                            ],
                            [
                                "Private",
                                58.1
                            ],
                            [
                                "Government",
                                1.5
                            ],
                            [
                                "Education",
                                2.3
                            ]
                        ],
                        "fillRate": 99.99874461754774,
                        "highestValue": [
                            "Private",
                            58.1
                        ]
                    },
                    "Generations": {
                        "data": [
                            [
                                "iGen",
                                0
                            ],
                            [
                                "Millenial",
                                0
                            ],
                            [
                                "Gen X",
                                0
                            ],
                            [
                                "Baby Boomer",
                                0
                            ],
                            [
                                "Silent",
                                0
                            ],
                            [
                                "Greatest",
                                0
                            ]
                        ],
                        "fillRate": 0,
                        "highestValue": [
                            "",
                            0
                        ]
                    },
                    "NumChildren": {
                        "data": [
                            [
                                0,
                                0
                            ],
                            [
                                "1-2",
                                0
                            ],
                            [
                                "3-4",
                                0
                            ],
                            [
                                "5 +",
                                0
                            ]
                        ],
                        "fillRate": 0,
                        "highestValue": [
                            "",
                            0
                        ]
                    },
                    "Technologies": {
                        "data": [],
                        "fillRate": 0,
                        "highestValue": [
                            "Act on",
                            0
                        ]
                    },
                    "MaritalStatus": {
                        "data": [
                            [
                                "M",
                                0
                            ],
                            [
                                "S",
                                0
                            ]
                        ],
                        "fillRate": 0,
                        "highestValue": [
                            "",
                            0
                        ]
                    },
                    "EmployeesCount": {
                        "data": [
                            [
                                "1-10",
                                34.6
                            ],
                            [
                                "10-250",
                                19.1
                            ],
                            [
                                "250-1,000",
                                3.4
                            ],
                            [
                                "1,000-10,000",
                                2.8
                            ],
                            [
                                "10,000-50,000",
                                0
                            ],
                            [
                                "50,000-100,000",
                                0
                            ],
                            [
                                "100,000 +",
                                39.9
                            ]
                        ],
                        "fillRate": 92.48276987584268,
                        "highestValue": [
                            "100,000 +",
                            40
                        ]
                    },
                    "TitleAgeGender": {
                        "data": [
                            {
                                "F": 0,
                                "M": 0,
                                "Title": "chief"
                            },
                            {
                                "F": 0,
                                "M": 0,
                                "Title": "vp"
                            },
                            {
                                "F": 0,
                                "M": 0,
                                "Title": "manager"
                            },
                            {
                                "F": 0,
                                "M": 0,
                                "Title": "non-manager"
                            }
                        ],
                        "fillRate": 0,
                        "highestValue": [
                            "",
                            0
                        ]
                    },
                    "YearsAtBusiness": {
                        "data": [],
                        "fillRate": 0,
                        "highestValue": [
                            "",
                            0
                        ]
                    },
                    "YearsInBusiness": {
                        "data": [
                            [
                                "< 2",
                                0.2
                            ],
                            [
                                "2-10",
                                50.8
                            ],
                            [
                                "11-15",
                                5.4
                            ],
                            [
                                "16-20",
                                5.7
                            ],
                            [
                                "21-25",
                                6.9
                            ],
                            [
                                "26-30",
                                4.5
                            ],
                            [
                                "31 +",
                                26.5
                            ]
                        ],
                        "fillRate": 77.46086345205066,
                        "highestValue": [
                            "2-10",
                            50.7
                        ]
                    },
                    "YearsAtBusinessIncome": {
                        "data": [
                            [
                                "< 50,000",
                                0
                            ],
                            [
                                "50,000-149,000",
                                0
                            ],
                            [
                                "150,000-249,000",
                                0
                            ],
                            [
                                "250,000 +",
                                0
                            ]
                        ],
                        "fillRate": 0,
                        "highestValue": [
                            "",
                            0
                        ]
                    }
                }
            },
            "state_url": "https://api.versium.com/v2/jobs/810271",
            "callback_url": null,
            "suppression_input_list_ids": null,
            "est_sec_remaining": 0,
            "progress_percentage": 100
        }
    }
}

When the job has completed, a “download_url” will be provided, and the “state” will be “done”.

Download List

API End point: https://api.versium.com/v2/lists//download

Note: the API End point is fully provided in the state_url - Example from above "state_url": "https://api.versium.com/v2/jobs/622002"

Method: GET

Response Structure
If successful, this URL will download the following:

  • when using operation b2b_persona_email: a CSV formatted list
  • when using operation b2b_persona_online_audience: a zip file containing the csv audiences formatted for the various services (1 file per service).