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

# Get Business Data

> Retrieve information about businesses on the server.

Available actions:
- `list` - list of all businesses (requires page, limit).
- `info` - business information (requires businessId or businessName).
- `balance` - business balance (requires businessId).
- `employees` - business employees (requires businessId, page, limit).
- `store` - business products (requires businessName).
- `transfers` - business transfers (requires businessId, page, limit).
- `rating` - top businesses by balance (requires limit).
- `pending` - pending business creation requests.




## OpenAPI

````yaml en/openapi/en-economy-v2-openapi.yaml GET /moscowroleplay/civops/businesses
openapi: 3.1.0
info:
  title: ER:LC Russia API V2 - Moscow RolePlay Economy API V2
  version: 2.0.0
servers:
  - url: https://api.erlcrussia.xyz/v2
    description: ER:LC Russia API V2
security: []
tags:
  - name: Moscow RolePlay Economy API V2
    description: Endpoints for managing economy and CivOps system.
paths:
  /moscowroleplay/civops/businesses:
    get:
      tags:
        - Moscow RolePlay Economy API V2
      summary: Get Business Data
      description: |
        Retrieve information about businesses on the server.

        Available actions:
        - `list` - list of all businesses (requires page, limit).
        - `info` - business information (requires businessId or businessName).
        - `balance` - business balance (requires businessId).
        - `employees` - business employees (requires businessId, page, limit).
        - `store` - business products (requires businessName).
        - `transfers` - business transfers (requires businessId, page, limit).
        - `rating` - top businesses by balance (requires limit).
        - `pending` - pending business creation requests.
      parameters:
        - name: action
          in: query
          description: Action type for retrieving data.
          required: true
          schema:
            type: string
            enum:
              - list
              - info
              - balance
              - employees
              - store
              - transfers
              - rating
              - pending
        - name: businessId
          in: query
          description: Business ID (for info, balance, employees, transfers).
          required: false
          schema:
            type: string
        - name: businessName
          in: query
          description: Business name.
          required: false
          schema:
            type: string
        - name: limit
          in: query
          description: Record limit.
          required: false
          schema:
            type: integer
            default: 10
        - name: page
          in: query
          description: Page number.
          required: false
          schema:
            type: integer
            default: 1
      responses:
        '200':
          description: Successful response with business data.
          content:
            application/json:
              schema:
                type: object
              examples:
                list:
                  summary: Business list.
                  value:
                    page: 1
                    total: 50
                    businesses:
                      - id: UCEW29
                        user_id: '760966468715937814'
                        username: ttunku_pal
                        name: Roma Aeterna
                        form: ООО
                        status: active
                        created_at: 1761587615
                        approved_by: '1133665013794607114'
                        owner_id: '760966468715937814'
                        owner_name: ttunku_pal
                        channel_id: '1432651696210841760'
                        channel_name: 🇮🇹┃roma-aeterna
                        role_id: '1432651691987304522'
                        role_name: Roma Aeterna
                        employee_role_id: '1432651694289846302'
                        employee_role_name: Сотрудник Бизнеса Roma Aeterna
                        description: >-
                          В «Roma Aeterna» мы верим, что лучшие беседы рождаются
                          за вкусной едой. Наше кафе создано для того, чтобы вы
                          чувствовали себя как в гостях у друзей в солнечной
                          Италии.
                        info_msg_id: '1432651699952156712'
                        address: 2221 Southern Avenue
                        bank: 350
                info:
                  summary: Business information.
                  value:
                    business:
                      id: UCEW29
                      user_id: '760966468715937814'
                      username: ttunku_pal
                      name: Roma Aeterna
                      form: ООО
                      status: active
                      created_at: 1761587615
                      approved_by: '1133665013794607114'
                      owner_id: '760966468715937814'
                      owner_name: ttunku_pal
                      channel_id: '1432651696210841760'
                      channel_name: 🇮🇹┃roma-aeterna
                      role_id: '1432651691987304522'
                      role_name: Roma Aeterna
                      employee_role_id: '1432651694289846302'
                      employee_role_name: Сотрудник Бизнеса Roma Aeterna
                      description: >-
                        В «Roma Aeterna» мы верим, что лучшие беседы рождаются
                        за вкусной едой.
                      info_msg_id: '1432651699952156712'
                      address: 2221 Southern Avenue
                      bank: 350
                balance:
                  summary: Business balance.
                  value:
                    businessId: UCEW29
                    balance:
                      bank: 350
                employees:
                  summary: Business employees.
                  value:
                    businessId: UCEW29
                    employees:
                      - id: 61
                        business_id: UCEW29
                        user_id: '1335499851273601029'
                        username: ytkaytkovich_16555
                        position: Сотрудник
                        joined_at: 1761661225
                      - id: 65
                        business_id: UCEW29
                        user_id: '813472799280726017'
                        username: ._ethea1th
                        position: Менеджер
                        joined_at: 1763834359
                      - id: 66
                        business_id: UCEW29
                        user_id: '1195675629010558986'
                        username: m1xsimus_
                        position: Менеджер
                        joined_at: 1763834389
                    totalCount: 3
                store:
                  summary: Business products.
                  value:
                    businessName: Roma Aeterna
                    items:
                      - business_name: Roma Aeterna
                        name: ☕ 1. Noctis Amor
                        description: >-
                          («Любовь ночи») Густой эспрессо с ванильной пенкой и
                          каплей карамели.
                        price_buy: 250
                        quantity: 1000
                        createdAt: 1761779241065
                      - business_name: Roma Aeterna
                        name: '🌟 Pièce de Résistance: Aurum Caeli et Roma Aeterna'
                        description: >-
                          Филе осетра, обжаренное на сливочном масле с
                          трюфельной ноткой...
                        price_buy: 5500
                        quantity: 98
                        createdAt: 1761783355402
                transfers:
                  summary: Business transfers.
                  value:
                    businessId: UCEW29
                    rows:
                      - id: V0CWNF2J
                        from_business_id: UCEW29
                        to_business_id: RAWDB4
                        amount: 10000
                        reason: ''
                        created_at: 1776628017744
                        author_id: '760966468715937814'
                    total: 1
                rating:
                  summary: Top businesses by balance.
                  value:
                    count: 0
                    businesses: []
                pending:
                  summary: Pending business creation requests.
                  value:
                    total: 2
                    requests:
                      - requestId: req_abc123
                        userId: '1133665013794607114'
                        username: IvanPetrov
                        name: Tech Solutions
                        form: ООО
                        channelId: '1417184142227144877'
                        status: pending
                        created_at: 1776628017744
        '400':
          description: Request error (missing required parameter or unknown action).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          $ref: '#/components/responses/UnauthorizedMissingOrInvalidToken'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
        - MRPAPIKey: []
components:
  schemas:
    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
    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.
      required:
        - code
        - message
      properties:
        code:
          type: integer
          example: 6021
        message:
          type: string
          example: Rate Limit Exceeded
        retry_after:
          type: integer
          description: Time until limit reset in seconds.
          example: 30
    EconomyApiError:
      type: object
      description: Economy API error.
      required:
        - code
        - message
      properties:
        code:
          type: integer
          example: 6010
        message:
          type: string
          example: Business not found
  responses:
    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.
      headers:
        X-RateLimit-Limit:
          description: Maximum requests per minute.
          schema:
            type: integer
            example: 60
        X-RateLimit-Remaining:
          description: Remaining number of requests.
          schema:
            type: integer
            example: 0
        Retry-After:
          description: Seconds until limit reset.
          schema:
            type: integer
            example: 30
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RateLimitError'
          examples:
            Rate Limit Exceeded:
              summary: Request limit exceeded.
              value:
                code: 6021
                message: Rate Limit Exceeded
                retry_after: 30
    InternalServerError:
      description: Internal server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/EconomyApiError'
          examples:
            Internal Server Error Occurred:
              summary: Economy API error.
              value:
                code: 6005
                message: Internal Server Error Occurred.
  securitySchemes:
    MRPAPIKey:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: |
        API key for accessing CivOps endpoints.

        Passed in the `Authorization: Bearer <key>` header.

        REQUIRED FOR ALL CIVOPS ENDPOINTS (except /health).

````