Skip to main content

Endpoint

GET https://theslow.net/api/email-forwarding/email-forwarding-status

Overview

This endpoint allows you to check if email forwarding is currently enabled on your account, and view the forwarding email address if set.

Authentication

This endpoint requires an API key. You can retrieve an API key from your dashboard. Include it in the X-API-KEY header:
X-API-KEY: YOUR_API_KEY_HERE
For more details, see the Authentication Guide.

Parameters

None
This endpoint does not require any path, query, or request body parameters.

Request Examples

cURL

curl -X GET   'https://theslow.net/api/email-forwarding/email-forwarding-status'   -H 'X-API-KEY: YOUR_API_KEY'   -H 'Content-Type: application/json'

Python

import requests

BASE_URL = "https://theslow.net/api"
API_KEY = "YOUR_API_KEY"

headers = {
    "X-API-KEY": API_KEY,
    "Content-Type": "application/json"
}

response = requests.get(
    f"{BASE_URL}/email-forwarding/email-forwarding-status",
    headers=headers
)

if response.ok:
    print("✅ Status:", response.json())
else:
    print("❌ Error:", response.status_code, response.json())

JavaScript (Fetch)

async function getForwardingStatus() {
  try {
    const response = await fetch("/api/email-forwarding/email-forwarding-status", {
      method: "GET",
      headers: {
        "X-API-KEY": "YOUR_API_KEY",
        "Content-Type": "application/json"
      }
    });

    if (!response.ok) {
      const errorData = await response.json();
      console.error("Failed to fetch:", errorData.error);
      return;
    }

    const data = await response.json();
    console.log("Forwarding Status:", data);
  } catch (err) {
    console.error("Unexpected error:", err);
  }
}

// Example usage:
// getForwardingStatus();

Responses

200 OK

Returns the forwarding status and forwarding email.
{
  "enabled": true,
  "email": "[email protected]"
}
{
  "enabled": false,
  "email": ""
}

401 Unauthorized

Occurs if authentication fails (e.g., missing or invalid API key).
{
  "error": "Unauthorized: You must be logged in or provide a valid API Key."
}

500 Internal Server Error

A server-side error occurred.
{
  "error": "An internal server error occurred."
}

Note on 404 from DB

If your profile does not yet exist in the database, the API gracefully returns:
{
  "enabled": false,
  "email": ""
}

Need Further Assistance?

If you have any questions or encounter issues, please don’t hesitate to reach out to our support team.