# List gas stations that could sponsor a specific account

Returns the gas stations that could be chosen as sponsor for the given account: every sponsor in the account domain or one of its ancestor domains, excluding the account itself. If the account is already effectively sponsored, returns isSponsored=true with the existing sponsor and an empty items list (an entity is only sponsored once), unless includeAll=true, in which case items still lists the lineage candidates (the current sponsor may appear among them).

Endpoint: GET /v1/domains/{domainId}/sponsors/account/{accountId}/valid-sponsors
Security: bearer

## Path parameters:

  - `domainId` (string, required)
    Domain ID of the account to list valid sponsors for

  - `accountId` (string, required)
    Account ID to list valid sponsors for

## Query parameters:

  - `includeAll` (boolean)
    When true, items lists the lineage candidates even if the account is already sponsored (the current sponsor may appear among them). Defaults to false.

## Response 200 fields (application/json):

  - `isSponsored` (boolean, required)
    Whether the account is already effectively sponsored

  - `sponsor` (object)
    The existing sponsor when the account is already sponsored

  - `sponsor.isSponsored` (boolean, required)
    Whether the account is sponsored by a gas station

  - `sponsor.sponsorAccountId` (string)
    Gas station account ID that is sponsoring

  - `sponsor.type` (string)
    Enum: "domain", "account", "none"

  - `sponsor.accountIds` (array)

  - `sponsor.includeSubDomains` (boolean)

  - `sponsor.alertLimit` (array)

  - `sponsor.alertLimit.tickerId` (string, required)
    Ticker/token UUID

  - `sponsor.alertLimit.amount` (string, required)
    Alert threshold amount

  - `sponsor.balanceStatus` (array)
    Balance status per configured alert. Omitted if balance fetch fails.

  - `sponsor.balanceStatus.tickerId` (string, required)
    Ticker UUID

  - `sponsor.balanceStatus.tickerSymbol` (string, required)
    Ticker symbol for display (e.g., SOL, ETH, XRP)

  - `sponsor.balanceStatus.threshold` (string, required)
    Configured alert threshold amount

  - `sponsor.balanceStatus.currentBalance` (string, required)
    Current balance from Core

  - `sponsor.balanceStatus.status` (string, required)
    Balance status: critical if currentBalance <= threshold
    Enum: "healthy", "critical"

  - `sponsor.criticalCount` (number)
    Number of tickers in critical status. Omitted if balance fetch fails.

  - `items` (array, required)
    Gas stations that could be chosen as sponsor. Empty when the account is already sponsored, unless includeAll=true was requested, in which case the lineage candidates are still listed (the current sponsor may appear among them).

  - `items.accountId` (string, required)
    Gas station account ID that can be chosen as sponsor

  - `items.accountAlias` (string)
    Alias of the gas station account, if known

  - `items.domainId` (string, required)
    Domain ID the gas station belongs to

  - `items.domainAlias` (string)
    Alias of the domain the gas station belongs to, if known