📚v1 API Reference

PRC API v1 is public and outlined on this page. PRC API v2 is currently in beta testing (closed access, you cannot apply or gain access) and will replace version one soon.

API Authentication

All requests to the API must have a valid Server-Key header provided.

Not sure where to find your server key?

Join your private server, open the settings, and search for "API key" under the ER:LC API header.

API Reference

PRC moderators and the API development team are unable to provide support with coding or integrating the API into third party solutions.

POST endpoints have higher rate limits, ensure you are reading and respecting all rate limit headers!

Run a command as a player named "virtual server management"

post

Authorizations

ServerKeyAuth

server-keystringRequired

REQUIRED ON ALL REQUESTS.

Body

application/json

commandstringOptional

The command to be executed

Example: :h Hey everyone!

Responses

200

Command executed successfully

No content

400

Bad request

403

Unauthorized

422

The private server has no players in it

500

Problem communicating with Roblox

post

/server/command

HTTPcURLJavaScriptPython

POST /v1/server/command HTTP/1.1
Host: api.policeroleplay.community
server-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "command": ":h Hey everyone!"
}

No content

Fetch server status

get

Authorizations

ServerKeyAuth

server-keystringRequired

REQUIRED ON ALL REQUESTS.

Responses

200

Server status data

application/json

NamestringOptionalExample: API Test

OwnerIdintegerOptional

CoOwnerIdsinteger[]Optional

CurrentPlayersintegerOptional

MaxPlayersintegerOptional

JoinKeystringOptionalExample: APIServer

AccVerifiedReqstringOptionalExample: Disabled / Email / Phone/ID

TeamBalancebooleanOptional

403

Unauthorized

get

/server

HTTPcURLJavaScriptPython

GET /v1/server HTTP/1.1
Host: api.policeroleplay.community
server-key: YOUR_API_KEY
Accept: */*

{
  "Name": "API Test",
  "OwnerId": 1,
  "CoOwnerIds": [
    1
  ],
  "CurrentPlayers": 1,
  "MaxPlayers": 1,
  "JoinKey": "APIServer",
  "AccVerifiedReq": "Disabled / Email / Phone/ID",
  "TeamBalance": true
}

Fetch players in server

get

Authorizations

ServerKeyAuth

server-keystringRequired

REQUIRED ON ALL REQUESTS.

Responses

200

Players in server

application/json

PlayerstringOptionalExample: PlayerName:Id

PermissionstringOptionalExample: Normal / Server Administrator / Server Owner / Server Moderator

Callsignstring · nullableOptionalExample: The player's callsign - only available if the player is on a non-civilian team

TeamstringOptionalExample: The player's team

403

Unauthorized

get

/server/players

HTTPcURLJavaScriptPython

GET /v1/server/players HTTP/1.1
Host: api.policeroleplay.community
server-key: YOUR_API_KEY
Accept: */*

[
  {
    "Player": "PlayerName:Id",
    "Permission": "Normal / Server Administrator / Server Owner / Server Moderator",
    "Callsign": "The player's callsign - only available if the player is on a non-civilian team",
    "Team": "The player's team "
  }
]

Fetch join logs

get

Authorizations

ServerKeyAuth

server-keystringRequired

REQUIRED ON ALL REQUESTS.

Responses

200

Join logs data

application/json

JoinbooleanOptionalExample: true

TimestampintegerOptionalExample: 1704614400

PlayerstringOptionalExample: PlayerName:Id

403

Unauthorized

get

/server/joinlogs

HTTPcURLJavaScriptPython

GET /v1/server/joinlogs HTTP/1.1
Host: api.policeroleplay.community
server-key: YOUR_API_KEY
Accept: */*

[
  {
    "Join": true,
    "Timestamp": 1704614400,
    "Player": "PlayerName:Id"
  }
]

Fetch players in queue

get

Authorizations

ServerKeyAuth

server-keystringRequired

REQUIRED ON ALL REQUESTS.

Responses

200

Players in queue (by Roblox id)

application/json

integer[]Optional

403

Unauthorized

get

/server/queue

HTTPcURLJavaScriptPython

GET /v1/server/queue HTTP/1.1
Host: api.policeroleplay.community
server-key: YOUR_API_KEY
Accept: */*

[
  1
]

Fetch kill logs

get

Authorizations

ServerKeyAuth

server-keystringRequired

REQUIRED ON ALL REQUESTS.

Responses

200

Kill logs data

application/json

KilledstringOptionalExample: PlayerName:Id

TimestampintegerOptionalExample: 1704614400

KillerstringOptionalExample: PlayerName:Id

403

Unauthorized

get

/server/killlogs

HTTPcURLJavaScriptPython

GET /v1/server/killlogs HTTP/1.1
Host: api.policeroleplay.community
server-key: YOUR_API_KEY
Accept: */*

[
  {
    "Killed": "PlayerName:Id",
    "Timestamp": 1704614400,
    "Killer": "PlayerName:Id"
  }
]

Fetch command logs

get

Authorizations

ServerKeyAuth

server-keystringRequired

REQUIRED ON ALL REQUESTS.

Responses

200

Command logs data

application/json

PlayerstringOptionalExample: PlayerName:Id

TimestampintegerOptionalExample: 1704614400

CommandstringOptionalExample: :h

403

Unauthorized

get

/server/commandlogs

HTTPcURLJavaScriptPython

GET /v1/server/commandlogs HTTP/1.1
Host: api.policeroleplay.community
server-key: YOUR_API_KEY
Accept: */*

[
  {
    "Player": "PlayerName:Id",
    "Timestamp": 1704614400,
    "Command": ":h"
  }
]

Fetch moderator call logs

get

Authorizations

ServerKeyAuth

server-keystringRequired

REQUIRED ON ALL REQUESTS.

Responses

200

Moderator call logs data. 'Moderator' is only sent if a mod has responded to the call.

application/json

CallerstringOptionalExample: PlayerName:Id

Moderatorstring · nullableOptionalExample: PlayerName:Id

TimestampintegerOptionalExample: 1704614400

403

Unauthorized

get

/server/modcalls

HTTPcURLJavaScriptPython

GET /v1/server/modcalls HTTP/1.1
Host: api.policeroleplay.community
server-key: YOUR_API_KEY
Accept: */*

[
  {
    "Caller": "PlayerName:Id",
    "Moderator": "PlayerName:Id",
    "Timestamp": 1704614400
  }
]

Fetch bans

get

Authorizations

ServerKeyAuth

server-keystringRequired

REQUIRED ON ALL REQUESTS.

Responses

200

Bans data

application/json

PlayerIdstringOptionalExample: PlayerName

403

Unauthorized

get

/server/bans

HTTPcURLJavaScriptPython

GET /v1/server/bans HTTP/1.1
Host: api.policeroleplay.community
server-key: YOUR_API_KEY
Accept: */*

{
  "PlayerId": "PlayerName"
}

Fetch a list of spawned vehicles in the server

get

Authorizations

ServerKeyAuth

server-keystringRequired

REQUIRED ON ALL REQUESTS.

Responses

200

Vehicles in the server

application/json

Texturestring · nullableOptionalExample: Standard

NamestringOptionalExample: 2019 Falcon Interceptor Utility

OwnerstringOptionalExample: flat_bird

403

Unauthorized

get

/server/vehicles

HTTPcURLJavaScriptPython

GET /v1/server/vehicles HTTP/1.1
Host: api.policeroleplay.community
server-key: YOUR_API_KEY
Accept: */*

[
  {
    "Texture": "Standard",
    "Name": "2019 Falcon Interceptor Utility",
    "Owner": "flat_bird"
  }
]

Deprecated

Fetch a list of the server's staff (mods + admins)

get

Authorizations

ServerKeyAuth

server-keystringRequired

REQUIRED ON ALL REQUESTS.

Responses

200

Server Staff

application/json

CoOwnersinteger[]Optional

List of Roblox user IDs who are co-owners of the server

AdminsobjectOptional

Map of Roblox user IDs to usernames for server administrators

Example: {"54249787":"Black_Hallow","77573259":"sli_ckk"}

ModsobjectOptional

Map of Roblox user IDs to usernames for server moderators

Example: {"2":"JohnDoe","3":"JaneDoe"}

403

Unauthorized

get

/server/staff

HTTPcURLJavaScriptPython

GET /v1/server/staff HTTP/1.1
Host: api.policeroleplay.community
server-key: YOUR_API_KEY
Accept: */*

{
  "CoOwners": [
    1
  ],
  "Admins": {
    "54249787": "Black_Hallow",
    "77573259": "sli_ckk"
  },
  "Mods": {
    "2": "JohnDoe",
    "3": "JaneDoe"
  }
}

^ /v1/server/staff will continue working despite deprecation, however, it will not be updated and you may experience bugs.

Resetting a global API key:

If you were issued a global API key, you can reset it by sending a POST to /v1/api-key/reset with the "authorization" header set as your API key. This will send a new key which can only be viewed once. If you lose the key, the person who requested the API key must contact PRC.