---
title: "Brokerage Session Status"
method: POST
path: "/iserver/auth/status"
tags: ["tradingSession"]
---

# Brokerage Session Status

`POST /iserver/auth/status`

Current Authentication status to the Brokerage system. Market Data and Trading is not possible if not authenticated.

## Response `200`

Detailed status of the Brokerage session

- BrokerageSessionStatus
  - `authenticated` boolean — Returns whether your brokerage session is authenticated or not.
  - `established` boolean — Returns whether your brokerage session is fully established and ready to handle requests. Set to true when the login message is received from underlying brokerage infrastructure, indicating authentication is complete and account information is loaded.
  - `competing` boolean — Returns whether you have a competing brokerage session in another connection.
  - `connected` boolean — Returns whether you are connected to the gateway or not.
  - `message` string — A message about your authenticate status if any.
  - `MAC` string — Device MAC information.
  - `serverInfo` BrokerageSessionStatusServerInfo
    - `serverName` string — IBKR server information. Internal use only.
    - `serverVersion` string — IBKR version information. Internal use only.
  - `hardware_info` string — Client Portal use only.
  - `fail` string — Returns the reason for failing to retrieve authentication status.

## Other responses

- `401` — Missing, invalid, or unparseable Authorization token.

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)