Anon.li provides developer-friendly REST APIs for both email aliasing and encrypted file sharing. Build privacy-first applications with zero-knowledge encryption and secure email forwarding. ## Getting Started ### 1. Create an API Key Generate an API key in your [Dashboard](/dashboard/api-keys). Your key will start with `ak_` and should be kept secret. ### 2. Authenticate Requests Include your API key in the `Authorization` header: ```bash Authorization: Bearer ak_your_api_key_here ``` ### 3. Choose Your API

Alias API

Create and manage email aliases programmatically. Forward emails to any inbox while protecting your real address.

Drop API

Upload and share end-to-end encrypted files. Zero-knowledge storage with automatic expiration and download limits.

## Base URL All API endpoints are relative to: ``` https://anon.li/api/v1 ``` ## Security Features - **API Key Authentication** - Secure Bearer token authentication - **Rate Limiting** - Protection against abuse with per-endpoint limits - **End-to-End Encryption** - Files are encrypted client-side (File API) - **Zero Knowledge** - We never see your unencrypted data ## Rate Limits Rate limits vary by endpoint. When you exceed a limit, you'll receive a `429 Too Many Requests` response with headers indicating when you can retry: ``` X-RateLimit-Limit: 60 X-RateLimit-Remaining: 0 X-RateLimit-Reset: 1699999999999 Retry-After: 3600 ``` ## Error Format All errors follow a consistent format: ```json { "error": "Error message describing what went wrong" } ``` ## Need Help? - Check the [Alias API documentation](/docs/api/alias) for email aliasing - Check the [Drop API documentation](/docs/api/drop) for encrypted file sharing - Contact support at [hi@anon.li](mailto:hi@anon.li)