> ## Documentation Index
> Fetch the complete documentation index at: https://docs.limitless.exchange/llms.txt
> Use this file to discover all available pages before exploring further.

# Maintenance Status

> Returns active and scheduled maintenance information. Use this endpoint to detect temporary trading restrictions and planned maintenance notices.

Use this endpoint to check whether trading is currently restricted or whether a future maintenance notice is scheduled.

<Info>
  This endpoint is public and does not require authentication.
</Info>

For integration guidance, see [Maintenance Mode](/developers/maintenance-mode).


## OpenAPI

````yaml GET /maintenance/status
openapi: 3.0.0
info:
  title: Limitless Exchange API
  description: >-
    Production-ready REST API for prediction market trading, portfolio
    management, and market data on Limitless Exchange (Base L2).
  version: '1.0'
  contact:
    name: API Support
    url: https://limitless.exchange
    email: help@limitless.network
servers:
  - url: https://api.limitless.exchange
    description: Production API
security: []
tags:
  - name: Authentication
    description: User authentication and session management
  - name: Markets
    description: Browse, search, and analyze prediction markets
  - name: Market Navigation
    description: Navigation tree, market pages, and property filters
  - name: Trading
    description: Create, manage, and cancel orders
  - name: Portfolio
    description: Position tracking, trade history, and performance
  - name: API Tokens
    description: Scoped API token management for partner integrations
  - name: Partner Accounts
    description: Sub-account creation and allowance recovery for partner integrations
  - name: System
    description: Public API state and availability information
paths:
  /maintenance/status:
    get:
      tags:
        - System
      summary: Get maintenance status
      description: >-
        Returns active and scheduled maintenance information. Use this endpoint
        to detect temporary trading restrictions and planned maintenance
        notices.
      operationId: MaintenanceController_getStatus
      parameters:
        - name: target
          in: query
          required: false
          description: >-
            Optional maintenance target filter. Use `trading` to return only
            trading-related maintenance effects.
          schema:
            type: string
            enum:
              - trading
      responses:
        '200':
          description: Maintenance status returned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MaintenanceStatus'
              examples:
                normal:
                  summary: No active or scheduled maintenance
                  value:
                    active: []
                    scheduled: []
                tradingRestricted:
                  summary: >-
                    Trading currently cancel-only with a scheduled post-only
                    stage
                  value:
                    active:
                      - startsAt: '2026-06-22T15:00:00.000Z'
                        endsAt: '2026-06-22T18:00:00.000Z'
                        publicMessage: Trading is temporarily limited to cancellations.
                        effects:
                          - target: trading
                            mode: cancel_only
                    scheduled:
                      - startsAt: '2026-06-22T18:00:00.000Z'
                        endsAt: '2026-06-22T19:00:00.000Z'
                        publicMessage: >-
                          Trading will be post-only during the next maintenance
                          stage.
                        effects:
                          - target: trading
                            mode: post_only
components:
  schemas:
    MaintenanceStatus:
      type: object
      description: Current and scheduled maintenance information.
      properties:
        active:
          type: array
          description: Maintenance effects currently in force.
          items:
            $ref: '#/components/schemas/MaintenanceWindow'
        scheduled:
          type: array
          description: Future maintenance notices.
          items:
            $ref: '#/components/schemas/MaintenanceWindow'
      required:
        - active
        - scheduled
    MaintenanceWindow:
      type: object
      description: A maintenance window or notice.
      properties:
        startsAt:
          type: string
          format: date-time
          description: When the maintenance window starts.
        endsAt:
          type: string
          format: date-time
          description: When the maintenance window ends, if known.
        publicMessage:
          type: string
          description: Human-readable message intended for users or integration operators.
        effects:
          type: array
          description: Public effects clients should apply for this maintenance window.
          items:
            $ref: '#/components/schemas/MaintenanceEffect'
      required:
        - startsAt
        - effects
    MaintenanceEffect:
      type: object
      description: An effect applied during maintenance.
      properties:
        target:
          type: string
          enum:
            - trading
          description: The public API surface affected by this maintenance effect.
        mode:
          type: string
          enum:
            - post_only
            - cancel_only
            - disabled
          description: >-
            The trading restriction mode. No active trading effect means normal
            trading behavior.
      required:
        - target
        - mode

````