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

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

Endpoint: GET //v1/domains/{domainId}/sponsors/sponsored-domains
Security: bearer

## Path parameters:

  - `domainId` (string, required)
    Domain ID to list sponsored sub-domains for

## Query parameters:

  - `limit` (number)
    Maximum number of items per page

  - `startingAfter` (string)
    Cursor for pagination - returns items after this ID

  - `sortBy` (string)
    Field to sort by

  - `sortOrder` (string)
    Sort direction
    Enum: "asc", "desc"

  - `sponsorAccountId` (string)
    Filter by a specific sponsor account ID. When provided, only entities sponsored by this sponsor are marked as sponsored.

## Response 200 fields (application/json):

  - `items` (array, required)
    List of sponsored entities

  - `items.id` (string, required)
    Entity ID (Account or Domain UUID)

  - `items.alias` (string, required)
    Entity display name/alias

  - `items.isSponsored` (boolean, required)
    Whether the entity is sponsored by a Gas Station

  - `items.path` (array, 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


## Response 500 fields

## Response 503 fields