---
title: "List sub-domains in a domain with their sponsorship status"
method: GET
path: "/v1/domains/{domainId}/sponsors/sponsored-domains"
tags: ["Gas station"]
---

# List sub-domains in a domain with their sponsorship status

`GET /v1/domains/{domainId}/sponsors/sponsored-domains`

## Request

- Base URL: `https://docs.ripple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.ripple.com/v1/domains/{domainId}/sponsors/sponsored-domains`
- Auth: HTTP bearer

Returns all sub-domains within the domain along with whether each sub-domain is currently sponsored by a Gas Station.

## Path parameters

- `domainId` string, uuid, required

## Query parameters

- `limit` number
- `startingAfter` string
- `sortBy` string
- `sortOrder` 'asc' | 'desc'
- `sponsorAccountId` string, uuid

## Response `200`

List of sub-domains with sponsorship status

- GasStationSponsoredEntitiesResponseDto
  - `items` GasStationSponsoredEntityDto[], required: List of sponsored entities
    - `id` string, uuid, required: Entity ID (Account or Domain UUID)
    - `alias` string, required: Entity display name/alias
    - `isSponsored` boolean, required: Whether the entity is sponsored by a Gas Station
    - `path` string[], required: Domain hierarchy from root to entity (for Lineage column)
  - `count` number, required: Total count of items in current page
  - `currentStartingAfter` string: Current pagination cursor
  - `nextStartingAfter` string: Next pagination cursor for fetching more items

## Other responses

- `500`: Database error
- `503`: External service unavailable

---

[API](https://skmtc.dev/ripple/apis/ripple-custody-api.md) - [All operations](https://skmtc.dev/ripple/apis/ripple-custody-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ripple/apis/ripple-custody-api/revisions/c6f0ad6b70c0?raw)