AtData's List API can process up to 1,000,000 customer records for SafeToSend, Demographics, or Identity Matching asynchronously. It provides faster results than calling the regular APIs one record at a time.
API Keys
The services linked to your API key will define which will be executed in the List API requests. For example, if you use an API key related to the SafeToSend service, the list submitted will be processed in the respective service only.
Features
The List API allows you to:
- Submit lists to AtData for processing.
- Retrieve the processed results.
- Check the status of lists and the services running on them.
- Post a webhook/callback URL to alert you that your list process is complete (or in case of an error).
Endpoints
The List API offers you the following endpoints:
Submit List POST
Upload a list for AtData to process.
View EndpointCheck List Status GET
Check the status of your uploaded list.
View EndpointPurchase List Results POST
Acquire the results of a service.
View EndpointRetrieve List Results GET
Retrieve the results of a submitted list once the status of a list returns as Results.
Response Reference
Find details about the response fields in the List API responses: