Delivery Methods

SDX offers three ways to receive licensed content. Choose the method that fits your infrastructure and workflow.

API delivery

Access licensed content programmatically through the SDX Licensed Content API.

Base URL: https://api.sdx.dev/v1/licensed-content

Authentication

Licensed content API access uses the same authentication mechanism as the main SDX API. Your buyer account receives an API key with the licensed_content:read scope.

List your subscriptions

curl https://api.sdx.dev/v1/licensed-content/subscriptions \
  -H "Authorization: Bearer YOUR_API_KEY"

Retrieve a product

curl "https://api.sdx.dev/v1/licensed-content/products/sdx_market_benchmark?period=2025-Q4&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query parameters:

ParameterTypeDescription
periodstringReporting quarter (e.g. 2025-Q4)
formatstringjson, csv, or parquet
segmentsstringComma-separated segment filters (e.g. office,US,large)

Webhooks for new releases

Subscribe to the licensed_content.published webhook event to be notified when a new quarterly release is available:

curl -X POST https://api.sdx.dev/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.com/webhooks/sdx-content",
    "events": ["licensed_content.published"]
  }'

SFTP delivery

For buyers who prefer file-based delivery, SDX can push content to your SFTP server on a recurring schedule.

Setup

  1. Provide your SFTP server hostname, port, and directory path.
  2. Upload your SSH public key to the SDX buyer portal, or request SDX to generate a key pair.
  3. Select the products, formats, and delivery schedule.

Delivery schedule

OptionDescription
QuarterlyFiles delivered within 5 business days of each quarter close
MonthlyAvailable for products with monthly granularity
On releaseFiles pushed as soon as a new version is published

File naming convention

Files are named with a consistent pattern:

sdx_{product}_{period}_{schema_version}.{format}.gz

Example: sdx_market_benchmark_2025Q4_v2.json.gz

Delivery confirmation

SDX sends a manifest file alongside each delivery listing the files, their checksums (SHA-256), and sizes. A notification email is also sent to the configured recipients.

Bulk download

Download licensed content directly from the SDX buyer portal.

  1. Log into sdx.dev/buyer.
  2. Navigate to Licensed Content > Downloads.
  3. Select the product, period, and format.
  4. Click Download.

Files are available for 90 days from the release date. Archived releases can be requested from SDX support.

Download sizes

ProductTypical size (compressed)
Market benchmark (JSON)2–5 MB
Market index (CSV)< 1 MB
Anonymised building dataset (Parquet)50–200 MB
Emission factor dataset (CSV)3 MB

Delivery SLA

SDX commits to the following service levels for licensed content delivery:

MetricTarget
Publication dateWithin 15 business days of quarter close
API availability99.9% uptime
SFTP deliveryWithin 24 hours of publication
Support responseWithin 1 business day

Next steps