Error Codes

Error Response Format

All errors are returned in JSON format with code and message fields. For example:

{
  "code": 5007,
  "message": "Missing Token"
}

ER:LC Russia API Error Table

Authentication and Token Errors

Code	Description	Meaning
`5006`	Invalid Master Key	Invalid master key. Check the `erlcrussia-api-master-key` header
`5007`	Missing Token	Authorization token is missing. Add the `Authorization: Bearer <token>` or `erlcrussia-api-key: <token>` header
`5008`	Invalid Token	The token is invalid, disabled or deleted
`5033`	Unauthorized	No valid session or key for this route
`5009`	Forbidden	Access to this endpoint or action is forbidden for your token
`5010`	Api Version Forbidden	The key is not allowed to use this API version
`5011`	Query Param Forbidden	Access to the specified query parameters is forbidden by key permissions
`5037`	Invalid Signature	Invalid ED25519 digital signature on the request

Request and Resource Errors

Code	Description	Meaning
`5001`	Missing Discord Id	`discord_id` is missing. Add the `discord_id` field to the request body
`5002`	Missing Parameters	Required parameters are missing. Check request body or query parameters
`5003`	Invalid Version	Invalid API version in route. Use the current `v3` version
`5004`	Invalid Param Name	Invalid query parameter name
`5005`	Missing Command	Command was not sent. Add the `command` field to the request body
`5012`	Discord Id Not Found	No user with this Discord ID
`5013`	Token Not Found	Token not found
`5014`	Token Not Found Or Deleted	Token not found or was deleted
`5020`	Not Found	Requested resource or endpoint was not found
`5021`	Webhook Url Already Exists	Webhook URL is already registered in the system
`5022`	Webhook Not Found	Webhook not found
`5023`	Webhook Url Not Found	Webhook URL not found
`5025`	Websocket Key Not Found	WebSocket key not found
`5026`	Invalid Subscription Channel	Invalid subscription channel
`5034`	Invalid Json	Invalid JSON format in request body
`5035`	Missing Signature Headers	Signature headers missing (`X-Signature-Ed25519`, `X-Signature-Timestamp`)
`5036`	Timestamp Too Old	Request timestamp is too old (more than 5 minutes)
`5038`	Insufficient AI Credits	Insufficient AI credits on balance to complete the request
`5040`	Model Not Found	Requested AI model was not found
`5041`	Asset Not Found	CDN asset was not found
`5042`	Folder Not Found	CDN folder was not found
`5043`	Item Not Found	Requested item was not found
`5044`	User Not Found	User not found
`5045`	Insufficient Balance	Insufficient balance to complete operation
`5046`	Order Not Found	Order was not found
`5047`	Points Limit Exceeded	Daily points limit exceeded
`5048`	Insufficient Points	Insufficient points to perform the operation
`5050`	Roblox Account Not Linked	Roblox account is not linked to Discord
`5051`	Webhook Verification Failed	The webhook URL failed the signature check. The reason is in `reason`: `private_host`, `unreachable`, `signed_rejected`, `forged_accepted`, `signing_unavailable`

Server, Queue and Limit Errors

Code	Description	Meaning
`5015`	Command Queue Full	Command queue is full. Try again later
`5016`	Rate Limit Exceeded	Request limit exceeded. Wait for reset (see `Retry-After`)
`5017`	Internal Error	Internal server error. Retry later
`5018`	Server Error	Error communicating with upstream external API
`5019`	Prc Api Error	Error from the official PRC API. See `prc_code` field
`5024`	Cache Expired	Cache has expired and is temporarily unavailable
`5028`	Endpoint is deprecated	Endpoint is deprecated. Please use current API V3 version
`5039`	Spam Blocked	Request was blocked by the anti-spam filter
`5049`	Bad Gateway	Gateway unavailable when contacting internal or external service

WebSocket Gateway Errors

Code	Description	Meaning
`5101`	Invalid Message Format	Check JSON format and the `action` field
`5102`	Token Required	Add the `token` field to the `auth` message
`5107`	Not Authenticated	Send an `auth` message before any other actions
`5108`	Invalid Token	Check your WebSocket token
`5109`	Connection Blocked	Contact administrator
`5117`	Authentication Failed	Internal error. Try again later
`5127`	Connected	Informational code, no action required
`5128`	Auth Success	Informational code, no action required
`5129`	Pong	Informational code, no action required
`5130`	Subscription Denied	No permission for this data channel
`5131`	Subscribed	Informational code, no action required
`5132`	Unsubscribed	Informational code, no action required
`5133`	Cache Empty	Data has not loaded yet, please wait
`5134`	Empty Snapshot	Cache exists, but has no data for your subscriptions

CDN and AI Gateway Errors

Code	Description	Meaning
`5135`	CDN Path Already Exists	File path already exists. Automatic overwrite is disabled
`5136`	CDN Folder Slug Already Exists	Folder slug is already taken. Choose another folder slug
`5137`	CDN Folder Not Found	CDN folder with specified ID was not found
`5138`	CDN Storage Unavailable	CDN storage is temporarily unavailable
`5139`	CDN Source Unavailable	External source failed to deliver file during import
`5140`	AI Response Unavailable	AI model produced no usable response
`5141`	AI Model Unavailable	AI model is temporarily unavailable

Economy API Errors

Code	Description	Meaning
`6000`	Unknown Error Occurred	Check logs, contact administrator
`6001`	Database Error Occurred. Please Try Again Later.	Retry request after a few seconds
`6002`	Invalid Amount Specified.	Check amount format (must be a positive number)
`6003`	Invalid Or Missing Parameters.	Check required parameters in request
`6004`	Requested Resource Not Found.	Check resource ID
`6005`	Internal Server Error Occurred.	Retry request later
`6006`	Discord Operation Failed.	Check bot permissions in Discord
`6007`	Data Serialization Error.	Contact administrator
`6008`	Guild Not Found	Check `guildId` in parameters
`6009`	Discord Channel Not Found	Check `channelId` in request
`6010`	Business Not Found	Check `businessId` or `businessName`
`6011`	Mafia Not Found	Check `mafiaId` or `mafiaName`
`6012`	Transaction Not Found	Check `transactionId`
`6013`	Item Not Found	Check `itemName`
`6014`	Request Not Found Or Expired	Check `requestId`
`6015`	Duplicate Entry Found.	Resource already exists
`6016`	User Not Found	Check `userId`
`6017`	Insufficient Funds	User has insufficient funds
`6018`	Invalid Action Specified	Check `action` parameter
`6019`	Missing Required Fields	Fill in all required fields
`6020`	Permission Denied	Check token and permissions
`6021`	Rate Limit Exceeded	Wait for rate limit reset

ER:LC API Error Table

These error codes are returned from the external PRC Private Server API when querying */erlc/* endpoints.

System Errors

Code	Meaning
`0`	Unknown error occurred. If this persists, contact ER:LC Russia support via ticket (we will forward details to PRC support).
`1001`	Error communicating with Roblox or the in-game private server.
`1002`	An internal system error occurred on PRC servers.

Authentication Errors

Code	Meaning
`2000`	You did not provide a server-key.
`2001`	You provided an incorrectly formatted server-key.
`2002`	You provided an invalid or expired server-key.
`2003`	You provided an invalid global API key.
`2004`	Your server-key is currently banned from accessing the API.
`2005`	You are making unauthenticated requests on behalf of multiple servers. Create a public application and send its API key in the Authorization header.

Request Errors

Code	Meaning
`3001`	You did not provide a valid command in the request body.
`3002`	The server you are attempting to reach is currently offline (has no players).

Rate Limit and Access Errors

Code	Meaning
`4000`	You are not authorized to perform this action on this server.
`4001`	You are being rate limited, or are temporarily blocked. Check the message and Retry-After header.
`4002`	The command you are attempting to run is restricted.
`4003`	The message you are trying to send is prohibited.

Special Codes

Code	Meaning
`9998`	The resource you are accessing is restricted.
`9999`	The module running on the in-game ER:LC server is out of date.

Handling code 9999

Error code 9999 means the in-game module on the ER:LC private server is outdated. To resolve this, kick all players from the private server so it restarts and updates the module, then retry your request.

Handling code 0

If you receive error code 0 (unknown error) and it persists across multiple requests, open an API ticket in our Discord server and include the details of your request so our team can investigate.

Getting started

Documentation

Policies

Error Response Format

ER:LC Russia API Error Table

ER:LC API Error Table

Handling code 9999

Handling code 0

​Error Response Format

​ER:LC Russia API Error Table

​ER:LC API Error Table

​Handling code 9999

​Handling code 0

Error Response Format

ER:LC Russia API Error Table

ER:LC API Error Table

Handling code 9999

Handling code 0