Developer API

Contents:

Access to the developer API is open to everyone with a delivr.to account, and is fully-featured. Anything you can do in the UI, you can achieve with the API.

What you can do

  • Run campaigns and retrieve results
  • Upload custom payloads
  • Browse and download from the payload catalogue

📚 Full documentation: API Reference

Authentication

delivr.to uses API keys for authentication.

Generate an API key

  1. Visit the API Keys section of Settings
  2. Click Create and optionally set an expiry time (default: 180 days, max: 365)
  3. Copy your API key immediately — it cannot be retrieved later

Using your API key

Include this header in your requests:

Authorization: YOUR_API_KEY

Example: Get your user account info:

curl --request GET \
     --url https://api.delivr.to/me \
     --header 'Authorization: YOUR_API_KEY' \
     --header 'accept: application/json'

Revoking Keys

  1. Visit the API Keys section of Settings
  2. Click Delete and confirm
  3. The key is immediately invalidated and can no longer be used