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

# Get a connection status

> Returns the current lifecycle status for a single broker connection account by id. The caller must have intent read authorization. The handler verifies the trading account exists through the credentials service, then reads the account's active or pending connection status from KV.



## OpenAPI

````yaml /api-reference/connections.openapi.json get /v1/connections/status/{account_id}
openapi: 3.1.0
info:
  title: connection
  description: ''
  license:
    name: ''
  version: 0.1.0
servers:
  - url: https://api.anthid.com
    description: Production
security: []
tags:
  - name: Connections
    description: Connection Manager API
paths:
  /v1/connections/status/{account_id}:
    get:
      tags:
        - Connections
      summary: Get a connection status
      description: >-
        Returns the current lifecycle status for a single broker connection
        account by id. The caller must have intent read authorization. The
        handler verifies the trading account exists through the credentials
        service, then reads the account's active or pending connection status
        from KV.
      operationId: getConnectionStatusById
      parameters:
        - name: account_id
          in: path
          description: Broker connection account id
          required: true
          schema:
            type: string
            format: uuid
          example: 550e8400-e29b-41d4-a716-446655440000
      responses:
        '200':
          description: Connection status retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TradingAccountStatus'
              example:
                last_update_at: '2026-06-03T12:00:00Z'
                status: Ok
                trading_account_id: 550e8400-e29b-41d4-a716-446655440000
        '401':
          description: Missing or invalid authentication credentials
          content:
            text/plain:
              schema:
                type: string
        '403':
          description: Caller lacks intent read permission
          content:
            text/plain:
              schema:
                type: string
        '429':
          description: Caller exceeded the request rate limit
          content:
            text/plain:
              schema:
                type: string
        '500':
          description: >-
            Unexpected server error while resolving the trading account or
            reading active/pending connection status
          content:
            text/plain:
              schema:
                type: string
      security:
        - bearerAuth: []
        - clientCredentials: []
        - apiKeyAuth: []
components:
  schemas:
    TradingAccountStatus:
      type: object
      required:
        - trading_account_id
        - status
        - last_update_at
      properties:
        last_update_at:
          type: string
          format: date-time
        status:
          $ref: '#/components/schemas/ClientStatus'
        trading_account_id:
          type: string
          format: uuid
    ClientStatus:
      oneOf:
        - type: string
          enum:
            - Pending
        - type: string
          enum:
            - Ok
        - type: object
          required:
            - Error
          properties:
            Error:
              type: string
        - type: string
          enum:
            - Unknown
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    clientCredentials:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Machine bearer token minted via the client_credentials grant.
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````