> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aris247.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /v1/listings/featured

> Returns the brokerage's featured/promoted listings from IDX Broker.

Returns the brokerage's featured/promoted listings. These are listings the agent has manually promoted in their IDX Broker dashboard.

## Request

```bash theme={null}
curl -X POST \
  "https://dqgynnlsclfbqysauesf.supabase.co/functions/v1/api-router/v1/listings/featured" \
  -H "Content-Type: application/json" \
  -H "X-ARIS-API-Key: aris_yourkey" \
  -d '{"limit": 10, "page": 1}'
```

### Body parameters

<ParamField body="agentId" type="string">Filter to a specific agent's listings.</ParamField>
<ParamField body="officeId" type="string">Filter to a specific office's listings.</ParamField>
<ParamField body="limit" type="integer" default="10">Results per page.</ParamField>
<ParamField body="page" type="integer" default="1">Page number.</ParamField>

## Response

```json theme={null}
{
  "data": [
    {
      "listingId": "b67890",
      "address": "456 Oak Ave, Austin, TX 78704",
      "price": "675000",
      "beds": 4,
      "baths": 3,
      "sqft": "2400",
      "photos": ["https://..."],
      "daysOnMarket": 7
    }
  ],
  "total": 12,
  "page": 1,
  "limit": 10,
  "hasMore": true
}
```