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

# Overview

> Query broker connection statuses last seen by the platform.

When a trading account is connected to a broker, Anthid establishes a persistent worker connection that maintains authentication, monitors account health, and synchronizes broker state with the platform.

This worker is represented by a trading account connection status. Connection APIs provide visibility into the worker’s current status, allowing clients to determine whether the broker is reachable and the integration is operating normally.

## Availability

Available on all plans.

## Intended Purpose

Use connection APIs to:

* List connection statuses for accounts visible to the caller
* Verify broker connectivity for a single trading account
* Monitor active and pending connection health
* Troubleshoot broker integration issues

The caller must have intent read authorization. User and API-key callers list accounts in their principal organization; service-account callers may list accounts visible to the service credentials.

## Endpoints

| Endpoint                                  | Purpose                                                            |
| ----------------------------------------- | ------------------------------------------------------------------ |
| `GET /v1/connections/status`              | List statuses for broker connection accounts visible to the caller |
| `GET /v1/connections/status/{account_id}` | Get the current status for one broker connection account           |

## Connection Lifecycle

1. Create a trading account
2. Configure broker credentials
3. Establish broker connectivity
4. Monitor connection status
5. Execute trading activity

## Connection States

A connection may report:

| State     | Description                                                                       |
| --------- | --------------------------------------------------------------------------------- |
| `Pending` | The connection is being established or has not reached an active state            |
| `Ok`      | Broker communication is healthy                                                   |
| `Error`   | The platform encountered a broker integration error and returned an error message |
| `Unknown` | No active or pending status is available                                          |

## Polling Considerations

Connection status represents the most recent state observed by the platform.

Status information may lag broker-side events depending on broker update frequency and network conditions.

## Common Use Cases

* Display broker health in dashboards
* Verify readiness before submitting orders
* Alert operators to broker outages
* Audit connection stability

## Related Resources

* Trading Accounts
* Credentials
* Orders
* Positions

## Support

For questions about authentication, request formats, or API behavior, contact [support@anthid.com](mailto:support@anthid.com).