Guides
Data Services

List Status Response Object

This object represents a response from the Check List Status endpoint:

📘

Click on each object for more information

list_id string
The AtData numeric identifier for the list.
Example: 4321

name string
The name of the list.
Example: customer_emails.csv

name string
The name of the list.
Example: customer_emails.csv

status string
The status of the list. See the table below for possible values.
Possible Values:

  • Pending: The list is currently being processed.
  • Results: The list has been processed, and results are available.
  • Completed: The list has been processed.
  • Processed: The list has been processed.
  • Failed: The processing of the list has failed.

records integer
The quantity of non-blank records in the file that have data to be processed. Header records will not be included in this count.
Example: 1002

size_bytes integer
The number of bytes of data that was originally contained in the list.
Example: 22709

created_at string
The date and time the list was submitted in ISO 8601 format. At all times, use the UTC zone.
Example: 2017-10-19T20:46:58Z"

services object

An object containing child objects for each service run on the list, such as email_validation.

input_count integer
The quantity of input records for the current service.
Example:

completed_count integer
The number of records processed for the current service. To gauge your response progress, compare the completed_count value to the input_count value.
Example:

status string
The status of each service being processed. See the table below for possible values.
Possible Values:

  • Pending: The service has not started.
  • Processing: The service is currently running.
  • Completed: The service has been completed.
  • Cancelled: The service was cancelled.
  • Error: The service failed and must be investigated or restarted.