SafeAdd API Documentation

Authorization: Bearer sk_live_your_api_key

curl https://api.safeadd.io/v1/profile/Builderman \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "username": "Builderman",
  "robloxId": "156",
  "status": "Mostly positive",
  "flags": [],
  "reviewCounts": {
    "comfortable": 14,
    "neutral": 3,
    "uncomfortable": 0,
    "veryUncomfortable": 0
  },
  "behaviorTags": [],
  "reportCount": 17,
  "updatedAt": "2026-04-21T10:00:00Z"
}

{
  "username": "SomeNewPlayer",
  "robloxId": null,
  "status": "Not enough data",
  "flags": [],
  "reviewCounts": {
    "comfortable": 0,
    "neutral": 0,
    "uncomfortable": 0,
    "veryUncomfortable": 0
  },
  "behaviorTags": [],
  "reportCount": 0,
  "updatedAt": null
}

const API_KEY = "sk_live_your_api_key";

async function lookupPlayer(username: string) {
  const res = await fetch(
    `https://api.safeadd.io/v1/profile/${username}`,
    { headers: { Authorization: `Bearer ${API_KEY}` } }
  );

  if (!res.ok) {
    const body = await res.json();
    throw new Error(body.error ?? `HTTP ${res.status}`);
  }

  return res.json();
}

// Usage
const data = await lookupPlayer("Builderman");
console.log(data.status);       // "Mostly positive"
console.log(data.reportCount);  // 17
console.log(data.reviewCounts); // { comfortable: 14, neutral: 3, ... }

import requests

API_KEY = "sk_live_your_api_key"
BASE_URL = "https://api.safeadd.io/v1"

def lookup_player(username: str) -> dict:
    res = requests.get(
        f"{BASE_URL}/profile/{username}",
        headers={"Authorization": f"Bearer {API_KEY}"},
    )
    res.raise_for_status()
    return res.json()

# Usage
data = lookup_player("Builderman")
print(data["status"])        # "Mostly positive"
print(data["behaviorTags"])  # []

# Check if the user has concerning signals
if data["status"] in ("Elevated concern", "Strong concern"):
    print(f"Warning: {username} has safety concerns")

local HttpService = game:GetService("HttpService")
local Players = game:GetService("Players")

local API_KEY = "sk_live_your_api_key" -- keep this server-side only

local function checkPlayer(player)
    local url = "https://api.safeadd.io/v1/profile/" .. player.Name

    local success, result = pcall(function()
        return HttpService:RequestAsync({
            Url = url,
            Method = "GET",
            Headers = {
                ["Authorization"] = "Bearer " .. API_KEY,
            },
        })
    end)

    if not success then
        warn("[SafeAdd] Request failed: " .. tostring(result))
        return nil
    end

    if result.StatusCode ~= 200 then
        warn("[SafeAdd] HTTP " .. result.StatusCode)
        return nil
    end

    local data = HttpService:JSONDecode(result.Body)
    return data
end

Players.PlayerAdded:Connect(function(player)
    local data = checkPlayer(player)
    if not data then return end

    print(player.Name .. " → " .. data.status)

    -- Example: warn moderators about concerning players
    if data.status == "Strong concern" or data.status == "Elevated concern" then
        -- Send to your admin notification system
        warn("[SafeAdd] ⚠ " .. player.Name .. " has status: " .. data.status)

        -- Optionally check specific behaviors
        for _, tag in ipairs(data.behaviorTags) do
            warn("  Flagged: " .. tag)
        end
    end

    -- Example: store the data for your moderation UI
    player:SetAttribute("SafeAddStatus", data.status)
    player:SetAttribute("SafeAddReports", data.reportCount)
end)

local ALLOWED_STATUSES = {
    ["Positive signal"] = true,
    ["Mostly positive"] = true,
    ["Not enough data"] = true,
}

local function canTrade(player)
    local status = player:GetAttribute("SafeAddStatus")
    if not status then return true end -- no data yet, allow
    return ALLOWED_STATUSES[status] == true
end

const { SlashCommandBuilder, EmbedBuilder } = require("discord.js");

const API_KEY = process.env.SAFEADD_API_KEY;

const STATUS_COLORS = {
  "Positive signal":  0x22c55e,
  "Mostly positive":  0x22c55e,
  "Not enough data":  0x9ca3af,
  "Mixed signal":     0xf59e0b,
  "Emerging concern": 0xf97316,
  "Elevated concern": 0xef4444,
  "Strong concern":   0xdc2626,
};

module.exports = {
  data: new SlashCommandBuilder()
    .setName("check")
    .setDescription("Check a Roblox player's safety status")
    .addStringOption((opt) =>
      opt.setName("username").setDescription("Roblox username").setRequired(true)
    ),

  async execute(interaction) {
    await interaction.deferReply();

    const username = interaction.options.getString("username");
    const res = await fetch(
      `https://api.safeadd.io/v1/profile/${username}`,
      { headers: { Authorization: `Bearer ${API_KEY}` } }
    );

    if (!res.ok) {
      return interaction.editReply("Failed to look up that player.");
    }

    const data = await res.json();
    const color = STATUS_COLORS[data.status] ?? 0x6b7280;

    const embed = new EmbedBuilder()
      .setTitle(data.username ?? username)
      .setColor(color)
      .addFields(
        { name: "Status", value: data.status, inline: true },
        { name: "Reports", value: String(data.reportCount), inline: true },
      );

    if (data.behaviorTags.length > 0) {
      embed.addFields({
        name: "Flagged Behaviors",
        value: data.behaviorTags.join(", "),
      });
    }

    if (data.flags.length > 0) {
      embed.setFooter({ text: data.flags.join(" · ") });
    }

    await interaction.editReply({ embeds: [embed] });
  },
};

{
  "status": "ok",
  "version": "1.0.0"
}