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

# List current sandbox agent viewings

`GET /agents/current/viewings`

## Request

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

Returns public-safe sandbox viewing status for the current sandbox agent when the authenticated automation client has `agent.viewings.read`. External URL: `/v1/agents/current/viewings`. Current Next.js implementation path: `/api/platform/v1/agents/current/viewings`. This read-only route does not require `Idempotency-Key`; SDK, CLI, and MCP viewing inspection may call this sandbox route while live viewing workflows, customer PII, customer contact fields, owner contact, private notes, routing data, live calendar data, calendar write controls, and delegated agency actors remain deferred.

## Headers

- `X-Correlation-Id` string

## Response `200`

Current sandbox agent public-safe viewing status.

- CurrentAgentViewingsResponse
  - `viewings` object, required: Public-safe sandbox viewing status for the current sandbox agent. Customer PII, customer contact fields, owner contact fields, private notes, routing data, live calendar data, and calendar write controls are not returned.
    - `agent_id` string, required
    - `summary` object, required
      - `total_viewings` integer, required
      - `requested_viewings` integer, required
      - `confirmed_viewings` integer, required
      - `completed_viewings` integer, required
      - `cancelled_viewings` integer, required
      - `live_calendar_returned` false, required
    - `viewings` object[], required
      - `viewing_id` string, required
      - `listing_id` string, required
      - `listing_title` string, required
      - `status` 'requested' | 'confirmed' | 'completed' | 'cancelled', required
      - `scheduled_window` object, required
        - `start_at` string, date-time, nullable, required
        - `end_at` string, date-time, nullable, required
        - `timezone` 'Asia/Singapore', required
      - `request_channel` 'homejourney_sandbox' | 'partner_sandbox', required
      - `visitor_context` object, required
        - `reference` string, required
        - `party_size` integer, required
        - `pii_returned` false, required
        - `contact_returned` false, required
      - `actions` object, required
        - `allowed` string[], required
        - `blocked` string[], required
    - `public_safety` object, required
      - `customer_pii_returned` false, required
      - `customer_contact_returned` false, required
      - `private_notes_returned` false, required
      - `owner_contact_returned` false, required
      - `routing_data_returned` false, required
      - `live_calendar_returned` false, required
      - `calendar_write_controls_returned` 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)
  - `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)