> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.erlcrussia.com/llms.txt > Use this file to discover all available pages before exploring further. # Elenco dei Ban del Server > Returns list of active bans on ER:LC server. ## OpenAPI ````yaml en/openapi/en-erlc-openapi.yaml GET /erlc/server/bans openapi: 3.1.0 info: title: Moscow RolePlay API - ER:LC Endpoints description: > **ATTENTION: This API v1 version is deprecated!** Most endpoints are disabled and return error 500. It is recommended to use the newer API version. Only endpoint working: `/erlc/server/bans` ## Rate Limits | Endpoint | Limit | |----------|-------| | `/erlc/server/*` (except command) | 120 requests/min | | `/erlc/server/command` | Queue: 100 commands | Returns **HTTP 429** when limit is exceeded. ## Error Response Format All errors are returned in JSON format with `code` and `message` fields: ```json { "code": 5007, "message": "missing_token" } ``` ## Error Codes ### Authentication and Access Errors | Code | Status | Description | |-----|--------|----------| | 5006 | 401 | invalid_master_key | | 5007 | 401 | missing_token | | 5008 | 401 | invalid_token | | 5009 | 403 | forbidden | | 5010 | 403 | api_version_forbidden | | 5011 | 403 | query_param_forbidden | ### PRC API Errors Endpoints use external PRC API and may return errors: | PRC Code | Description | |---------|----------| | 2002 | Invalid or expired server-key | | 3002 | Server is offline | | 4001 | Rate limited | | 9999 | Module out of date | When PRC API error occurs, returns: ```json { "code": 5019, "message": "prc_api_error", "prc_code": 2002, "prc_message": "Invalid or expired server-key" } ``` Base URL: `https://api.erlcrussia.xyz/v1` version: 1.0.0 servers: - url: https://api.erlcrussia.xyz/v1 description: Production security: [] tags: - name: ERLC description: ER:LC game server data and management. paths: /erlc/server/bans: get: tags: - ERLC summary: Server Ban List description: | Returns list of active bans on ER:LC server. responses: '200': description: Ban list. content: application/json: schema: type: object additionalProperties: type: string description: Object where key is PlayerId, value is player name. example: PlayerId: PlayerName '400': $ref: '#/components/responses/PRCAPIError' '401': $ref: '#/components/responses/UnauthorizedMissingOrInvalidToken' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' security: - MRPAPIKey: [] components: responses: PRCAPIError: description: Error from external PRC API (ER:LC). content: application/json: schema: type: object properties: code: type: integer example: 5019 message: type: string example: prc_api_error prc_code: type: integer description: PRC API error code. prc_message: type: string description: Error description. examples: expired_server_key: summary: Server-Key invalid or expired. value: code: 5019 message: prc_api_error prc_code: 2002 prc_message: Invalid or expired server-key server_offline: summary: Server offline (no players). value: code: 5019 message: prc_api_error prc_code: 3002 prc_message: Server is offline (no players) module_outdated: summary: Server module is outdated. value: code: 5019 message: prc_api_error prc_code: 9999 prc_message: In-game server module is out of date UnauthorizedMissingOrInvalidToken: description: Authentication error. content: application/json: schema: $ref: '#/components/schemas/UnauthorizedError' examples: missing_token: summary: No token. value: code: 5007 message: missing_token invalid_token: summary: Invalid or deactivated token. value: code: 5008 message: invalid_token invalid_master_key: summary: Invalid master key. value: code: 5006 message: invalid_master_key Forbidden: description: Access forbidden. content: application/json: schema: $ref: '#/components/schemas/ForbiddenError' examples: forbidden: summary: No access rights to endpoint. value: code: 5009 message: forbidden api_version_forbidden: summary: Access to this API version is forbidden. value: code: 5010 message: api_version_forbidden query_param_forbidden: summary: Query parameter is forbidden. value: code: 5011 message: query_param_forbidden TooManyRequests: description: >- Request limit exceeded (120/min) or spam detected (400+ excess requests). headers: X-RateLimit-Limit: description: Maximum requests per minute. schema: type: integer example: 120 X-RateLimit-Remaining: description: Remaining requests. schema: type: integer example: 0 X-RateLimit-Reset: description: Unix timestamp (ms) when limit resets. schema: type: integer example: 1740339600000 Retry-After: description: Seconds until limit resets. schema: type: integer example: 45 content: application/json: schema: oneOf: - $ref: '#/components/schemas/RateLimitError' - $ref: '#/components/schemas/SpamBlockedError' examples: rate_limit_exceeded: summary: Exceeded 120 requests/min limit. value: code: 5016 message: rate_limit_exceeded retry_after: 45 details: limit: 120 count: 125 excess: 5 reset_at: 1740339600000 spam_blocked: summary: Spam ban (400+ excess requests). value: code: 5023 message: spam_blocked blocked_until: 1740339900000 remaining_seconds: 300 InternalServerError: description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: server_error: summary: External ER:LC API error. value: code: 5018 message: server_error schemas: UnauthorizedError: type: object description: Authentication error (missing or invalid token). required: - code - message properties: code: type: integer example: 5007 message: type: string example: missing_token ForbiddenError: type: object description: Access error (forbidden). required: - code - message properties: code: type: integer example: 5009 message: type: string example: forbidden RateLimitError: type: object description: >- Request limit exceeded error (120/min). Returns details with counter info. required: - code - message - retry_after - details properties: code: type: integer example: 5016 message: type: string example: rate_limit_exceeded retry_after: type: integer description: Time until limit resets in seconds. example: 45 details: type: object properties: limit: type: integer description: Request limit per minute. example: 120 count: type: integer description: Current request count. example: 125 excess: type: integer description: Excess requests (over limit). example: 5 reset_at: type: integer description: Unix timestamp (ms) of limit reset. example: 1740339600000 SpamBlockedError: type: object description: >- Spam ban. Issued at 400+ excess requests. 5 minute ban + additional minutes for continued spam. required: - code - message - blocked_until - remaining_seconds properties: code: type: integer example: 5023 message: type: string example: spam_blocked blocked_until: type: integer description: Unix timestamp (ms) of ban end. example: 1740339900000 remaining_seconds: type: integer description: Seconds until unban. example: 300 ErrorResponse: type: object description: Standard error format. required: - code - message properties: code: type: integer description: API error code. example: 5007 message: type: string description: Error message/identifier. example: missing_token securitySchemes: MRPAPIKey: type: http scheme: bearer bearerFormat: API Key description: | Standard API key for accessing ER:LC endpoints. Passed in `Authorization: Bearer ` header. REQUIRED FOR ALL ER:LC ENDPOINTS. ````