---
title: "Get the single list info"
method: GET
path: "/lists/{list_id}"
tags: ["lists"]
---

# Get the single list info

`GET /lists/{list_id}`

## Request

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

## Path parameters

- `list_id` integer, required

## Response `200`

Response on success

- object
  - `success` 0 | 1: Success status, 0 for failed 1 for success
  - `message` string
  - `error_code` integer
  - `data` 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)