Skip to main content
Version: 1.0.0

ELLIO Public API

Public API for ELLIO Platform

Authentication​

All API endpoints require authentication using an API key. You can provide the key in one of two ways:

  1. Header (Recommended): Include your API key in the X-API-Key header
  2. Query Parameter: Include your API key as the apikey query parameter

API Key Permissions​

API keys have two permission levels:

  • read - Can view rulesets, rules, and business services data
  • read_write - Can perform all operations including creating, updating, and deleting rules

Each endpoint's documentation specifies the minimum required permission level.

Available Services​

IP Rulesets​

Manage allowlists and blocklists of IP addresses and CIDR ranges with expiration support.

Common Business Services (CBS)​

Access hierarchical IP range data from cloud providers, CDNs, and SaaS services. Browse by region or service, search by text or IP address, and identify which services an IP belongs to.

Error Responses​

All error responses follow RFC 9457 Problem Details format. Common error codes:

  • 401 Unauthorized - Missing or invalid API key
  • 403 Forbidden - Insufficient permissions for the requested operation
  • 429 Too Many Requests - Rate limit exceeded

Authentication​

API key for authentication. Include your API key in the X-API-Key header or as an 'apikey' query parameter. Obtain your API key from your organization settings in the ELLIO dashboard.

Security Scheme Type:

apiKey

Header parameter name:

X-API-Key