> ## 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.

# Current ER:LC Player Count

> Returns current player count on ER:LC server as plain text.




## OpenAPI

````yaml en/openapi/en-stats-openapi.yaml GET /moscowroleplay/stats/playercount
openapi: 3.1.0
info:
  title: Moscow RolePlay API - Stats Endpoints
  description: |
    Public Discord server statistics (no authorization required).

    ## Error Response Format

    All errors are returned in JSON format with `code` and `message` fields:

    ```json
    {

        "code": 5001,

        "message": "unsupported_server"

    }
    ```

    ## Error Codes

    | Code | Status | Description |
    |-----|--------|----------|
    | 5001 | 400 | unsupported_server |
    | 5016 | 429 | rate_limit_exceeded |
    | 5018 | 500 | server_error |

    Base URL: `https://api.erlcrussia.xyz/v1`
  version: 1.0.0
servers:
  - url: https://api.erlcrussia.xyz/v1
    description: Production
security: []
tags:
  - name: Stats
    description: Public statistics (no authorization required).
paths:
  /moscowroleplay/stats/playercount:
    get:
      tags:
        - Stats
      summary: Current ER:LC Player Count
      description: |
        Returns current player count on ER:LC server as plain text.
      responses:
        '200':
          description: Player count as string.
          content:
            text/plain:
              schema:
                type: string
                example: '25'
        '400':
          $ref: '#/components/responses/BadRequest'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security: []
components:
  responses:
    BadRequest:
      description: Bad request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    TooManyRequests:
      description: Request limit exceeded (20/min) or spam detected (400+ excess requests).
      headers:
        X-RateLimit-Limit:
          description: Maximum requests per minute.
          schema:
            type: integer
            example: 20
        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:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            too_many_requests:
              summary: Exceeded 20 requests/min limit.
              value:
                code: 5016
                message: rate_limit_exceeded
                retry_after: 45
                details:
                  limit: 20
                  count: 25
                  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 ERLC API error.
              value:
                code: 5018
                message: server_error
  schemas:
    ErrorResponse:
      type: object
      description: Standard error format.
      required:
        - code
        - message
      properties:
        code:
          type: integer
          description: API error code.
          example: 5001
        message:
          type: string
          description: Error message/identifier.
          example: unsupported_server

````