---
title: "Get the all list info"
method: GET
path: "/lists/"
tags: ["lists"]
---

# Get the all list info

`GET /lists/`

## Request

- Base URL: `https://api.listclean.xyz/v1`
- URL: `https://api.listclean.xyz/v1/lists/`
- Auth: API key in header `X-Auth-Token`

## Response `200`

Response on success

- object
  - `success` 0 | 1: Success status, 0 for failed 1 for success
  - `message` string
  - `error_code` integer
  - `data` object
    - `total` integer
    - `cursor` integer
    - `lists` object[]
      - `list_id` integer
      - `filename` string: Filename of list uploaded
      - `size_in_bytes` integer
      - `request_time` string: Uploaded time
      - `status` 'COMPLETED' | 'INPROCESS' | 'SUBMITTED': List status
      - `upload_id` string
      - `analytics` object
        - `summary` object
          - `total` integer: Total Email contacts
          - `duplicate` integer: Duplicate Email contacts
          - `dirty` object
            - `count` integer: Dirty Count
            - `perc` number: Dirty Rate
          - `clean` object
            - `count` integer: Clean Count
            - `perc` number: Clean Rate
        - `dirty_summary` object[]
          - `count` integer: Dirty analytic count
          - `perc` number: Dirty analytic Rate
          - `dirty_type` string: Dirtiness category
        - `clean_summary` object[]
          - `count` integer: Clean analytic Count
          - `perc` number: Clean analytic Rate
          - `clean_type` string: Clean category(e.g. High Quality, Low Quality, Medium Quality)
      - `cost` object
        - `rate` object
          - `INR` number: Amount in INR
          - `USD` number: Amount in US Dollar
        - `cost` object
          - `INR` number: Amount in INR
          - `USD` number: Amount in US Dollar

## Other responses

- `400`: List name is required
- `401`: Auth Failed

---

[API](https://skmtc.dev/listclean/apis/listclean-api-beta.md) · [All operations](https://skmtc.dev/listclean/apis/listclean-api-beta/llms.txt) · [OpenAPI document](https://skmtc.dev/listclean/apis/listclean-api-beta/revisions/780c4fe6db87?raw)