Skip to content
Documentation/API reference
API · emails

List emails

GET /api/v2/emails

Authorization

emails:read. Use a workspace-scoped bearer key or an authorized user session.

Parameters

All resource access is checked against the selected workspace and user permissions.

Request

Set INBOXIT_API_KEY in your server environment. The CLI can also use an authenticated user session.

Example
curl -X GET 'https://inboxit.wtf/api/v2/emails' \
  -H "Authorization: Bearer $INBOXIT_API_KEY"

CLI equivalent

Use INBOXIT_TOKEN for a scoped key, or inboxit login for a user session.

Example
inboxit emails list

Response

HTTP 200. Example values are illustrative; excerpts are marked.

Example
{
  "emails": []
}

Behavior & errors

Returns the last 100 workspace outbound records, newest first. Each item has id, sender, recipient, subject, status, message_id and created_at. GET /emails/{id} returns one email. Tracking fields include track_opens, track_clicks, opened_at, clicked_at, open_count, click_count and tracking_links. Common errors: 400 invalid input, 401 unauthenticated, 403 insufficient permission, 404 missing/inaccessible resource, 409 conflict, 429 rate/usage limit, 503 service unavailable. See Errors & retries for recovery guidance.