---
title: "List the current sandbox agency listing portfolio"
method: GET
path: "/agencies/current/listings"
tags: ["Agencies"]
---

# List the current sandbox agency listing portfolio

`GET /agencies/current/listings`

## Request

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

Returns public-safe sandbox agency listing portfolio rows when the authenticated automation client has `agency.listings.read`. External URL: `/v1/agencies/current/listings`. Current Next.js implementation path: `/api/platform/v1/agencies/current/listings`. This read-only route does not require `Idempotency-Key`; SDK, CLI, and MCP agency-listing inspection may call this sandbox route, while live listing ownership, delegated impersonation, publish/archive/distribution actions, owner contact, source-agent contact metadata, private notes, routing data, raw CRM data, and member write controls remain deferred.

## Query parameters

- `limit` integer
- `cursor` string

## Headers

- `X-Correlation-Id` string

## Response `200`

Public-safe sandbox agency listing portfolio.

- CurrentAgencyListingsResponse
  - `listings` AgencyListingPortfolioRow[], required: Public-safe sandbox agency listing portfolio rows. Owner contact, source-agent contact metadata, private notes, routing data, distribution controls, raw CRM data, and write controls are not returned.
    - `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
    - `agency_listing_status` 'active' | 'draft', required
    - `publish_state` 'published' | 'draft', required
    - `distribution_state` 'active' | 'unpublished', required
    - `team_ids` string[], required
    - `allowed_actions` string[], required
    - `blocked_actions` string[], required
    - `owner_agent` object, required
      - `agent_id` string, required
      - `display_name` string, required
      - `cea_registration_number` string, required
      - `cea_status` 'verified' | 'expired', required
      - `singpass_verified` boolean, required
    - `branch` AgencyTeamBranch, required
      - `branch_id` string, required
      - `name` string, required
      - `region` 'central' | 'east', required
    - `ownership` object, 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
    - `expired_agent_owned` integer, required
    - `delegated_actions_enabled` false, required
    - `write_controls_returned` false, required
  - `authorization` Authorization, required (unresolved $ref)
  - `principal` Principal, required (unresolved $ref)
  - `public_safety` object, required
    - `listing_fields` 'public_safe', required
    - `private_notes_returned` false, required
    - `owner_contact_returned` false, required
    - `source_agent_contact_returned` false, required
    - `routing_data_returned` false, required
    - `distribution_controls_returned` false, required
    - `raw_crm_data_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)