Submit Lists

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

This endpoint enables you to submit multiple customer records simultaneously. You have the flexibility to upload files in either CSV or TXT formats. For convenience and efficiency, you can compress the file using zip before submission. Choose between:

  • Text/CSV method: Upload a text file (.txt or .csv) by setting the request's Content-Type header to Content-Type: text/csv.
  • Multipart method: Set the Content-Type header to Content-Type: multipart/form-data and upload a compressed .zip file. This method is recommended as it's less likely to break when uploading large files.
📘

Tip

When submitting a .zip archive, it must contain only one file, which should have either a .txt or .csv extension. The name of the archive itself must end with .zip.

File Formatting

Before sending files to AtData, learn to correctly format the data inside the file for accurate data processing and verification by referring to the File Formatting page.

Purchasing Results

When sending files with this endpoint, you can define whether you want to automatically purchase and retrieve the results or not. This is defined by the action query parameter. By adding it with report value you will be saying to the system that you don't want to purchase the results right now, only receiving a match report until you use the Purchase List Results endpoint to actually buy the results. All services except SafeToSend support action=report.

Query Params
boolean
Defaults to false

Used to indicate the presence of a header line with a value of true or false. Must be used for non-email fields.

string
enum
Defaults to \\t

The character used to separate multiple columns within the file. Default variable is tab (\t).

Allowed:
string
enum
Defaults to process

Choose between processing the data, or generating a report from it:

  • process: Processes the data to purchase it. This option already purchases the results.
  • report: Generates a report from the data without purchasing it. To purchase the results you need to use the Purchase List Results endpoint.
Allowed:
string
Defaults to myfile.csv

File name, which must use one of these file extensions: .txt, .csv or .zip. Default value: myfile.csv.

string

A comma-separated list of the data fields you want returned. By default, all available fields are returned.

string

A valid webhook/callback URL with a max length of 512 characters, that can accept POST requests with a JSON payload and uses https or http (AtData recommends using https). This value must be URL Encoded.

Body Params
file

File with list of customers to be validated.

Headers
string
required

Your AtData API key

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json