Skip to main content
RevenueBase delivers data to a managed S3 bucket and grants your AWS account read access. Data is available in CSV, JSON, and Parquet formats — you get all three with every delivery. Each monthly delivery lands in a new date-stamped folder; previous deliveries are never overwritten.

​
Get access

1

Provide your AWS Account ID

Share your 12-digit AWS Account ID with your RevenueBase onboarding contact. This is required so we can grant your account access to our S3 bucket.
You can find your AWS Account ID in the top-right dropdown of the AWS Console, or by running aws sts get-caller-identity in the AWS CLI.
2

Receive your access credentials

Once provisioned, we’ll share your bucket details including:
  • S3 bucket alias (or ARN-based access point)
  • AWS region for the bucket (by default eu-north-1)
Store your credentials securely. Do not commit them to version control or share them over unencrypted channels.
3

Verify access

Test your connection using the AWS CLI:
aws s3 ls s3://<your-bucket-alias>/<delivery_date>/  \
  --request-payer requester  \
  --region <target-bucket-region>
You can also access via ARN:
aws s3 ls s3://arn:aws:s3:<region>:<account-id>:accesspoint/<access-point-name>/<delivery_date>/  \
  --request-payer requester  \
  --region <target-bucket-region>
Use the AWS CLI — not the AWS Console web UI — to access RevenueBase buckets. The Console does not support --request-payer and will return access errors.

​
Bucket structure

Your data lives in date-stamped folders within the S3 bucket. The path structure is: 
<delivery_date>/<dataset_name>/<file_format>/
Path segmentDescription
delivery_dateDate of delivery in YYYYMMDD format (e.g., 20260201)
dataset_nameThe dataset included in your subscription (e.g., per, org, or a pre-joined dataset)
file_formatOne of json, csv, or parquet
For more on Parquet, see the official Parquet documentation.
Data is split across multiple files within each delivery folder. This is by design — it enables parallel processing and significantly improves import performance for large datasets.

​
Next steps

Available tables

See which tables are included in your subscription and their S3 path patterns.

Data Freshness & Quality

How verification works, why records become stale, and quality assessment guidance.