---
title: "List gas stations that could sponsor a specific account"
method: GET
path: "/v1/domains/{domainId}/sponsors/account/{accountId}/valid-sponsors"
tags: ["Gas station"]
---

# List gas stations that could sponsor a specific account

`GET /v1/domains/{domainId}/sponsors/account/{accountId}/valid-sponsors`

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

## Path parameters

- `domainId` string, uuid, required
- `accountId` string, uuid, required

## Query parameters

- `includeAll` boolean

## Response `200`

Valid sponsor candidates returned

- GasStationValidSponsorsResponseDto
  - `isSponsored` boolean, required — Whether the account is already effectively sponsored
  - `sponsor` GasStationAccountSponsorResponseDto
    - `isSponsored` boolean, required — Whether the account is sponsored by a gas station
    - `sponsorAccountId` string — Gas station account ID that is sponsoring
    - `type` 'domain' | 'account' | 'none'
    - `accountIds` string[]
    - `includeSubDomains` boolean
    - `alertLimit` GasStationAlertLimitDto[]
      - `tickerId` string, required — Ticker/token UUID
      - `amount` string, required — Alert threshold amount
    - `balanceStatus` GasStationBalanceStatusDto[] — Balance status per configured alert. Omitted if balance fetch fails.
      - `tickerId` string, required — Ticker UUID
      - `tickerSymbol` string, required — Ticker symbol for display (e.g., SOL, ETH, XRP)
      - `threshold` string, required — Configured alert threshold amount
      - `currentBalance` string, required — Current balance from Core
      - `status` 'healthy' | 'critical', required — Balance status: critical if currentBalance <= threshold
    - `criticalCount` number — Number of tickers in critical status. Omitted if balance fetch fails.
  - `items` GasStationValidSponsorItemDto[], 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).
    - `accountId` string, required — Gas station account ID that can be chosen as sponsor
    - `accountAlias` string — Alias of the gas station account, if known
    - `domainId` string, required — Domain ID the gas station belongs to
    - `domainAlias` string — Alias of the domain the gas station belongs to, if known

---

[API](https://skmtc.net/ripple/apis/ripple-custody-api.md) · [All operations](https://skmtc.net/ripple/apis/ripple-custody-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ripple/ripple-custody-api/revisions/410038300d74/schema)