Submit Lists

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.