---
title: "Files list"
method: GET
path: "/bulkapi/v2/filelist"
tags: ["Bulk API"]
---

# Files list

`GET /bulkapi/v2/filelist`

## Request

- Base URL: `//bulkapi.millionverifier.com` (relative, and the document’s source URL is not known)
- URL: `//bulkapi.millionverifier.com/bulkapi/v2/filelist`
- Auth: none declared

Get a list of files according to the given filters

## Query parameters

- `key` string, required
- `offset` integer
- `limit` integer
- `id` integer
- `name` string
- `status` 'in_progress' | 'error' | 'finished' | 'canceled' | 'paused' | 'in_queue_to_start'
- `updated_at_from` string, yyyy-MM-dd HH:mm:ss
- `updated_at_to` string, yyyy-MM-dd HH:mm:ss
- `createdate_from` string, yyyy-MM-dd HH:mm:ss
- `createdate_to` string, yyyy-MM-dd HH:mm:ss
- `percent_from` integer
- `percent_to` integer
- `has_error` '1' | 't' | 'T' | 'TRUE' | 'True' | 'true' | '0' | 'f' | 'F' | 'FALSE' | 'False' | 'false'

## Response `200`

Succesful request

- object
  - `files` BulkapiUploadSuccess[]: An array of files
    - `file_id` string: The ID of the uploaded file
    - `file_name` string: The name of the uploaded file
    - `status` string: The status of the verification
    - `unique_emails` integer: The number of unique emails found in the file
    - `updated_at` string: The last update of the file
    - `createdate` string: The date of creation
    - `percent` integer: Progress percentage
    - `total_rows` integer: Total rows in the file
    - `verified` integer: Amount of verified
    - `unverified` integer: Amount of unverified
    - `ok` integer: Amount of ok emails
    - `catch_all` integer: Amount of catch all emails
    - `disposable` integer: Amount of disposable emails
    - `invalid` integer: Amount of invalid emails
    - `unknown` integer: Amount of unknown emails
    - `reverify` integer: Amount of emails that needs to be reverified
    - `credit` integer: Amount of credits needed for the verification of the file
    - `estimated_time_sec` integer: Amount of estimated seconds it will take to verify the file
    - `error` string: Any errors that happened with the file
  - `total` integer: The amount of total files matching the given filters

---

[API](https://skmtc.dev/millionverifier/apis/millionverifier-api.md) - [All operations](https://skmtc.dev/millionverifier/apis/millionverifier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/millionverifier/apis/millionverifier-api/revisions/f4cad21f5f62?raw)