How do I set up RestoreCord on my Discord server?

To set up RestoreCord, invite the bot to your server, grant it the necessary permissions, and configure your server settings through the RestoreCord dashboard.

What data does RestoreCord back up?

RestoreCord backs up server settings, roles, channels, messages, and member data, ensuring comprehensive restoration capabilities.

How often should I back up my Discord server?

It's recommended to perform backups regularly, especially after significant changes, to ensure data is up-to-date.

Can RestoreCord restore deleted messages?

Yes, RestoreCord can restore deleted messages if they were included in the most recent backup.

Is my data secure with RestoreCord?

RestoreCord prioritizes data security, utilizing encryption and secure storage methods to protect your information.

What happens if I encounter a 'Missing Permissions' error?

A 'Missing Permissions' error indicates that RestoreCord lacks the necessary permissions to perform certain actions. Ensure the bot has the 'Administrator' permission or the specific permissions required for its functions.

Can I use RestoreCord to migrate members between servers?

Yes, RestoreCord allows you to pull members from one server to another, facilitating server migrations.

Does RestoreCord comply with Discord's Terms of Service?

RestoreCord is designed to comply with Discord's Terms of Service, ensuring safe and legitimate use.

How can I contact RestoreCord support?

For support, visit our contact page at https://restorecord.com/contact or join our Discord server for assistance.

Analytics - RestoreCord Docs

Overview

Analytics endpoints require READ_ANALYTICS and return data for servers owned by the authenticated account. The current local handlers do not include sub-user analytics in API-key mode.

Endpoint: GET /api/v3/servers/analytics
Purpose: Dashboard member analytics by query type.

Endpoint: GET /api/v3/servers/firewall/analytics
Purpose: Firewall analytics across all owned servers or one internal serverId.

Endpoint: GET /api/v3/servers/{serverId}/firewall/analytics
Purpose: Firewall analytics for one internal RestoreCord server ID.

Endpoint: GET /api/v3/servers/members/events
Purpose: Verified/joined/deauthorized/left event timeline.

Endpoint: GET /api/v3/servers/migrations/stats
Purpose: Migration performance and retention metrics.

Endpoint	Purpose
`GET /api/v3/servers/analytics`	Dashboard member analytics by query type.
`GET /api/v3/servers/firewall/analytics`	Firewall analytics across all owned servers or one internal `serverId`.
`GET /api/v3/servers/{serverId}/firewall/analytics`	Firewall analytics for one internal RestoreCord server ID.
`GET /api/v3/servers/members/events`	Verified/joined/deauthorized/left event timeline.
`GET /api/v3/servers/migrations/stats`	Migration performance and retention metrics.

Some analytics are backed by ClickHouse. If that service is unavailable, the API may return a service-style error rather than an empty dataset.

Member Analytics

Auth: API key with READ_ANALYTICS or full session.

GET/api/v3/servers/analytics

Get Member Analytics

Returns one analytics query or a batched response for comma-separated query names.

qRequired

Location: query
Type: string

Query name. Supports comma-separated batching, for example `graph,recent,server`.

timeOptional

Location: query
Type: string
Default: 30d

Used by time-series queries. Handler accepts `90d`, `30d`, `14d`, `7d`, or `1d`.

limitOptional

Location: query
Type: number

Positive integer, capped at 100.

serverIdOptional

Location: query
Type: string

Optional internal RestoreCord server ID filter. Must belong to the account.

Parameter	Location	Type	Required
`q` Query name. Supports comma-separated batching, for example `graph,recent,server`.	query	string	Yes
`time`default 30d Used by time-series queries. Handler accepts `90d`, `30d`, `14d`, `7d`, or `1d`.	query	string	No
`limit` Positive integer, capped at 100.	query	number	No
`serverId` Optional internal RestoreCord server ID filter. Must belong to the account.	query	string	No

Query: graph
Description: Verification counts over the requested time range.

Query: recent
Description: Recently verified members.

Query: server
Description: Per-server member counts and metadata.

Query: country
Description: Members grouped by country.

Query: device
Description: Members grouped by operating system/device data.

Query: browser
Description: Members grouped by browser.

Query: map
Description: Country distribution suitable for map views.

Query: referrer
Description: Verification referrer distribution.

Query: integrity
Description: Account quality/integrity summary.

Query: isp
Description: ISP breakdown. The handler includes plan checks internally.

Query: state
Description: Region/state breakdown where data is available.

Query: city
Description: City breakdown where data is available.

Query	Description
`graph`	Verification counts over the requested time range.
`recent`	Recently verified members.
`server`	Per-server member counts and metadata.
`country`	Members grouped by country.
`device`	Members grouped by operating system/device data.
`browser`	Members grouped by browser.
`map`	Country distribution suitable for map views.
`referrer`	Verification referrer distribution.
`integrity`	Account quality/integrity summary.
`isp`	ISP breakdown. The handler includes plan checks internally.
`state`	Region/state breakdown where data is available.
`city`	City breakdown where data is available.

Example response JSON

{
  "success": true,
  "batch": true,
  "results": {
    "graph": { "success": true, "data": [] },
    "recent": { "success": true, "members": [] }
  }
}

Firewall Analytics: All Servers

Auth: API key with READ_ANALYTICS or full session.

GET/api/v3/servers/firewall/analytics

Get Firewall Analytics

Returns firewall totals, time series, top blocked sources, and recent logs for owned servers.

daysOptional

Location: query
Type: number
Default: 30

Lookback window in days. The route uses the provided number directly.

serverIdOptional

Location: query
Type: string

Optional internal RestoreCord server ID filter.

Parameter	Location	Type	Required
`days`default 30 Lookback window in days. The route uses the provided number directly.	query	number	No
`serverId` Optional internal RestoreCord server ID filter.	query	string	No

Example response JSON

{
  "success": true,
  "statistics": {
    "total": 120,
    "allowed": 80,
    "denied": 30,
    "passwordUsed": 4,
    "passwordInvalid": 1,
    "rateLimited": 2,
    "bypassUsed": 3,
    "verificationOverTime": [],
    "hourlyData": [],
    "topBlockedIPs": [{ "ip": "203.0.113.10", "count": 6 }],
    "topBlockedCountries": [{ "country": "US", "count": 10 }],
    "ruleEffectiveness": [],
    "recentLogs": []
  },
  "period": { "days": 30, "startDate": "...", "endDate": "..." },
  "servers": [{ "guildId": "123456789012345678", "name": "Main Server" }]
}

Firewall Analytics: Single Server

Auth: API key with READ_ANALYTICS or full session. serverId is the internal RestoreCord server ID.

GET/api/v3/servers/{serverId}/firewall/analytics

Get Server Firewall Analytics

Returns firewall analytics for one owned server.

serverIdRequired

Location: path
Type: string

Internal RestoreCord server ID.

daysOptional

Location: query
Type: number
Default: 30

Lookback window in days.

Parameter	Location	Type	Required
`serverId` Internal RestoreCord server ID.	path	string	Yes
`days`default 30 Lookback window in days.	query	number	No

Top blocked IPs are only included when the server has IP logging enabled and the account plan can access IP logging.

Member Events

Auth: API key with READ_ANALYTICS or full session.

GET/api/v3/servers/members/events

Get Member Events

Returns verified members plus Discord member event counts over time.

daysOptional

Location: query
Type: number
Default: 30

Lookback window, capped at 90 days.

serverIdOptional

Location: query
Type: string

Optional internal RestoreCord server ID filter.

Parameter	Location	Type	Required
`days`default 30 Lookback window, capped at 90 days.	query	number	No
`serverId` Optional internal RestoreCord server ID filter.	query	string	No

Plan: Free/Premium
Included event fields: verified, joined, deauthorized

Plan: Business
Included event fields: Adds left.

Plan: Enterprise
Included event fields: Adds massPing.

Plan	Included event fields
Free/Premium	`verified`, `joined`, `deauthorized`
Business	Adds `left`.
Enterprise	Adds `massPing`.

The response also includes migrationSeries for migration line metadata. Each data[] row may include matching dynamic migration_<id> values, set to null before the migration start date and successCount from the start date onward.

Example response JSON

{
  "success": true,
  "data": [
    {
      "date": "2026-06-30",
      "verified": 4,
      "joined": 6,
      "left": 1,
      "massPing": 0,
      "deauthorized": 2,
      "migration_42": 128
    }
  ],
  "migrationSeries": [
    {
      "key": "migration_42",
      "id": 42,
      "startedAt": "2026-06-30T10:00:00.000Z",
      "status": "COMPLETED",
      "successCount": 128,
      "totalCount": 150,
      "sourceGuildId": "111111111111111111",
      "targetGuildId": "222222222222222222"
    }
  ]
}

Migration Stats

Auth: API key with READ_ANALYTICS or full session.

GET/api/v3/servers/migrations/stats

Get Migration Stats

Returns migration totals, success rates, flow breakdowns, and retention data.

daysOptional

Location: query
Type: number
Default: 30

Lookback window. Must be from 1 to 365.

serverIdOptional

Location: query
Type: string

Optional internal RestoreCord server ID filter.

Parameter	Location	Type	Required
`days`default 30 Lookback window. Must be from 1 to 365.	query	number	No
`serverId` Optional internal RestoreCord server ID filter.	query	string	No

Example response JSON

{
  "success": true,
  "statistics": {
    "totalMigrations": 4,
    "successfulMigrations": 3,
    "failedMigrations": 1,
    "averageSuccessRate": 92.5,
    "totalMembersMigrated": 1200,
    "totalMembersJoined": 1200,
    "totalMembersLeft": 45,
    "memberRetentionRate": 96.3,
    "avgMigrationDuration": 180
  },
  "recentMigrations": [],
  "successRateOverTime": [],
  "memberFlowBreakdown": [],
  "memberMovementOverTime": [],
  "ratioDistribution": [],
  "total": 4
}

Errors and Access

Status: 400
Code: INVALID_INPUT
When: Unknown analytics query, invalid limit, invalid days, or malformed internal server ID.

Status: 401
Code: UNAUTHORIZED
When: Missing or invalid auth.

Status: 403
Code: INSUFFICIENT_PERMISSIONS
When: API key lacks READ_ANALYTICS or the plan does not allow a specific breakdown.

Status: 404
Code: NOT_FOUND
When: serverId was supplied but is not owned by the account.

Status: 503
Code: SERVICE_UNAVAILABLE
When: ClickHouse-backed analytics are temporarily unavailable.

Status	Code	When
400	`INVALID_INPUT`	Unknown analytics query, invalid `limit`, invalid `days`, or malformed internal server ID.
401	`UNAUTHORIZED`	Missing or invalid auth.
403	`INSUFFICIENT_PERMISSIONS`	API key lacks `READ_ANALYTICS` or the plan does not allow a specific breakdown.
404	`NOT_FOUND`	`serverId` was supplied but is not owned by the account.
503	`SERVICE_UNAVAILABLE`	ClickHouse-backed analytics are temporarily unavailable.