servers-frontend.fivem.net APIservers-frontend.fivem.net ↗
Retrieve live FiveM server data by CFX join code: status, player list, loaded resources, config vars, owner info, and more via a single API endpoint.
curl -X GET 'https://api.parse.bot/scraper/d35b0455-060f-48e0-9145-e60790e961df/get_server_details?server_id=abc123' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve detailed information about a FiveM server by its server ID. Returns server status, player list, resources, configuration variables, owner information, and connection endpoints. Returns input_not_found for unknown server IDs.
| Param | Type | Description |
|---|---|---|
| server_idrequired | string | The server identifier found in CFX.RE/JOIN/{server_id} URLs (e.g. '3a4ooy'). |
{
"type": "object",
"fields": {
"vars": "object - Server variables (tags, Discord, banners, locale, game build, etc.)",
"owner": "object - Owner information with id, name, profile_url, and avatar_url fields",
"status": "string - Server status: 'online', 'offline', 'empty', 'full', 'private', or 'suspended'",
"players": "array of objects - Connected players with id, name, and ping fields",
"hostname": "string - Raw hostname with color codes",
"last_seen": "string - Last seen timestamp in ISO 8601 format",
"resources": "array of strings - Server resources/scripts loaded",
"server_id": "string - The server endpoint identifier",
"is_private": "boolean - Whether server is private",
"burst_power": "integer - Server burst power",
"is_fallback": "boolean - Whether this is a fallback server",
"max_players": "integer - Maximum player capacity",
"server_name": "string - Clean server name (color codes removed)",
"icon_version": "integer - Icon version for icon API",
"player_count": "integer - Current number of connected players",
"upvote_power": "integer - Server upvote power",
"server_version": "string - FXServer version information",
"support_status": "string - Support status",
"connect_endpoints": "array of strings - Server connection endpoints (URLs or IPs)",
"enhanced_host_support": "boolean - Whether enhanced host support is enabled",
"steam_ticket_required": "boolean - Whether Steam ticket is required to connect"
},
"sample": {
"data": {
"vars": {
"tags": "mythicalbro, busted, pursuits, unique, pvp",
"Discord": "https://discord.busted.community",
"sv_projectName": "BUSTED: NA"
},
"owner": {
"id": 19368,
"name": "MythicalBro",
"avatar_url": "https://forum.cfx.re/user_avatar/forum.cfx.re/mythicalbro/128/9107_2.png",
"profile_url": "https://forum.cfx.re/u/MythicalBro"
},
"status": "offline",
"players": [],
"hostname": "BUSTED | NA | PvP | Cops vs Robber",
"last_seen": "2026-05-03T05:15:14.945604483Z",
"resources": [
"hardcap",
"console_log",
"bob74_ipl",
"core",
"data"
],
"server_id": "3a4ooy",
"is_private": false,
"burst_power": 0,
"is_fallback": false,
"max_players": 64,
"server_name": "BUSTED: NA",
"icon_version": -2112999989,
"player_count": 0,
"upvote_power": 3,
"server_version": "FXServer-master SERVER v1.0.0.28954 win32",
"support_status": "supported",
"connect_endpoints": [
"https://na.server.busted.community/"
],
"enhanced_host_support": true,
"steam_ticket_required": true
},
"status": "success"
}
}About the servers-frontend.fivem.net API
The FiveM Server Details API exposes 10+ structured fields for any FiveM server via the get_server_details endpoint, accepting a CFX.RE join code (e.g. 3a4ooy) and returning real-time server status, connected player list with ping values, loaded resources, configuration variables, owner profile, and connection identifiers. It covers the full server profile surfaced on the CFX server browser in a single call.
What the API Returns
The get_server_details endpoint accepts a single required parameter — server_id — which is the short alphanumeric code found in CFX.RE/JOIN/{server_id} links. The response includes a status field that distinguishes between six states: online, offline, empty, full, private, and suspended. Alongside status, the response provides hostname (the raw server name including color codes), last_seen as an ISO 8601 timestamp, and is_private to flag servers that are not publicly joinable.
Player and Resource Data
The players array lists every connected player at query time, with each entry containing an id, name, and ping value. This makes it straightforward to track concurrency, identify active sessions, or monitor latency per player. The resources array enumerates every script and resource loaded on the server — useful for detecting which frameworks (e.g. ESX, QBCore) or specific mods are active.
Configuration and Owner Fields
The vars object contains server-defined configuration variables, which typically include tags, Discord invite links, banner image URLs, locale, and game build version — the same metadata shown in the CFX server browser. The owner object provides the server owner's id, name, profile_url, and avatar_url from their CFX account. An unknown or invalid server_id returns an input_not_found response rather than an empty result, allowing callers to distinguish a missing server from an offline one.
- Monitor a FiveM community server's live player count and status for an uptime dashboard.
- Detect which server framework (ESX, QBCore, etc.) a server runs by inspecting the
resourcesarray. - Build a CFX server browser alternative by aggregating hostname, vars, and status across multiple server IDs.
- Alert a Discord community when a tracked server's
statuschanges fromonlinetoofflineusinglast_seen. - Audit server configuration by reading
varsfields like game build, locale, and banner settings. - Look up server ownership and link to the CFX profile using the
owner.profile_urlfield. - Track per-player ping over time using the
pingfield in theplayersarray for performance monitoring.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does FiveM have an official developer API for server data?+
What does the `status` field distinguish, and how is an empty server represented?+
status field returns one of six string values: online, offline, empty, full, private, or suspended. An empty status means the server is reachable but has zero connected players, which is distinct from offline (unreachable) or suspended (administratively disabled). The is_private boolean provides an additional signal independent of the private status value.Does the API return historical player counts or server uptime history?+
players, current status, and a last_seen timestamp. It does not expose uptime percentages, player count time series, or session history. You can fork this API on Parse and revise it to store responses over time and add a history endpoint.Can I query multiple servers in a single request or search servers by name?+
server_id per call and does not support batch lookups or name-based search. You can fork this API on Parse and revise it to add a batch endpoint that accepts a list of server IDs or a search-by-name capability.What happens if I pass an invalid or unknown server ID?+
input_not_found response for unrecognized server IDs, rather than an empty object or HTTP 404. This allows callers to clearly distinguish between a server that exists but is offline versus one that does not exist in the CFX registry at all.