---
title: "List current sandbox agent listings"
method: GET
path: "/agents/current/listings"
tags: ["Agents"]
---

# List current sandbox agent listings

`GET /agents/current/listings`

## Request

- Base URL: `https://platform-api.homejourney.sg/v1`
- URL: `https://platform-api.homejourney.sg/v1/agents/current/listings`
- Auth: HTTP bearer

Returns public-safe sandbox listing summaries owned by the current sandbox agent when the authenticated automation client has `agent.listings.read`. External URL: `/v1/agents/current/listings`. Current Next.js implementation path: `/api/platform/v1/agents/current/listings`. This read-only route does not require `Idempotency-Key`; SDK, CLI, and MCP listing inspection may call this sandbox route while live listing ownership, publish/archive/distribution actions, private notes, source-agent contact metadata, and delegated agency actors remain deferred.

## Query parameters

- `limit` integer
- `cursor` string

## Headers

- `X-Correlation-Id` string

## Response `200`

Current sandbox agent listing portfolio.

- CurrentAgentListingsResponse
  - `listings` object[], required
    - `id` string, required
    - `title` string, required
    - `property_type` string, required
    - `district` string, required
    - `approximate_location` string, required
    - `price` integer, required
    - `bedrooms` integer, required
    - `bathrooms` integer, required
    - `square_feet` integer, required
    - `public_media_url` string, uri, required
    - `source_updated_at` string, date-time, required
    - `freshness_status` 'fresh' | 'stale' | 'unknown', required
    - `livemode` false, required
    - `agent_listing_status` 'active' | 'draft', required
    - `publish_state` 'published' | 'draft', required
    - `visibility` 'public_safe' | 'sandbox_private_draft', required
    - `allowed_actions` string[], required
    - `blocked_actions` string[], required
    - `ownership` object, required
      - `agent_id` string, required
      - `agency_id` string, required
      - `source` 'sandbox_fixture', required
      - `delegated` false, required
  - `pagination` object, required
    - `limit` integer, required
    - `next_cursor` string, nullable, required
  - `portfolio_summary` object, required
    - `total` integer, required
    - `active` integer, required
    - `draft` integer, required
    - `remaining_slots` integer, required
    - `publish_allowed` false, required
  - `authorization` object, required
    - `organization_id` string, uuid, required
    - `client_id` string, uuid, required
    - `api_key_id` string, uuid, required
    - `granted_agent_scopes` PlatformScope[], required
    - `actor_model` 'api_key_automation_client', required
    - `live_agent_identity` 'deferred', required
  - `principal` Principal, required (unresolved $ref)
  - `public_safety` object, required
    - `listing_fields` 'public_safe', required
    - `private_notes_returned` false, required
    - `owner_contact_returned` false, required
    - `routing_data_returned` false, required
    - `distribution_controls_returned` false, required
  - `livemode` false, required
  - `request_id` string, required

## Other responses

- `400`: Request validation failed.
- `401`: Missing or invalid platform API key.
- `403`: Credential, environment, or scope is not allowed.
- `404`: Platform API feature or resource is not available.
- `429`: Rate limit exceeded.
- `500`: Unexpected platform API failure.

---

[API](https://skmtc.dev/homejourney/apis/homejourney-platform-api.md) · [All operations](https://skmtc.dev/homejourney/apis/homejourney-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/homejourney/apis/homejourney-platform-api/revisions/a2c6fe063db1?raw)