Receiving and Updating Data

Receiving the Data

You can receive your license delivery updates via AWS's S3 Service or via a list of presigned URLs you can use to download the data directly.

Follow the instructions for one of the data delivery methods below to begin receiving data.


Our preferred mode of delivery is via Amazon's AWS S3 service.

To set up for delivery:

  1. Sign into AWS S3 console
  2. Create a bucket for deliveries (e.g. s3://YOURCOMPANY-data-deliveries)
    2a. If you are using an existing bucket ensure Requester Pays is disabled
  3. Modify the bucket policy in the permissions tab
  4. Paste the following into your permissions and replace {{your bucket name}} with your new bucket name (something like YOURCOMPANY-data-deliveries) and hit save.
    "Version": "2012-10-17",
    "Statement": [
            "Sid": "People Data Labs Bucket Permissions",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::556708831556:role/pdl-customer-deliveries"
            "Action": [
            "Resource": [
                "arn:aws:s3:::{{your bucket name}}",
                "arn:aws:s3:::{{your bucket name}}/*"
  1. Email [email protected] with your bucket URL.

Note on S3 Saving

When you hit Save on the Bucket Policy page, AWS may not give a "Saved" notification message and also show the following message:

This message is normal for AWS but can be confusing. To confirm the new policy above is saved, refresh the page and see if the policy is still there.

Direct Download

If you're unable to receive the data via AWS, you may opt to receive your data as a list of temporary presigned URLs.

When a new version of the dataset is ready for you to ingest, we'll send you an email, letting you know your the dataset is ready for you to download. Once you email us back, confirming that you're ready to begin downloading the data, we'll send you a new-line separated text file of presigned urls. Each URL can be downloaded via a simple HTTP call.

Each presigned URL is only valid for 7 days after being generated. If you're unable to download the data within this span of time, email [email protected] and we'll generate a new set of presigned URLs for your delivery.

Did this page help you?