API Reference

Authentication

All API requests require an API key. Include it in the X-API-Key header or as a Bearer token in the Authorization header.

# Using X-API-Key header
curl https://api.simpleinboxes.com/v1/orders \
  -H "X-API-Key: si_live_your_api_key"

# Using Bearer token
curl https://api.simpleinboxes.com/v1/orders \
  -H "Authorization: Bearer si_live_your_api_key"

Create and manage API keys from your dashboard or via the API Keys endpoints below.

Base URL

https://api.simpleinboxes.com

All endpoints are prefixed with /v1. Requests and responses use JSON.

Errors

All errors return a consistent JSON shape with a machine-readable code and a human-readable message.

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Order not found"
  }
}

Orders

Create, list, update, and cancel inbox orders.

Domains

Manage domains, inboxes, and DNS records.

Clients

Manage client workspaces for agency accounts. Create, rename, and delete clients.

Wallet

Check balance and view transaction history.

API Keys

Manage your API keys programmatically.