---
title: "Inspect a viewing request"
method: GET
path: "/viewing-requests/{id}"
tags: ["Viewings"]
---

# Inspect a viewing request

`GET /viewing-requests/{id}`

## Request

- Base URL: `https://platform-api.homejourney.sg/v1`
- URL: `https://platform-api.homejourney.sg/v1/viewing-requests/{id}`
- Auth: HTTP bearer

Returns the public-safe status for a sandbox fixture or live platform-owned viewing request. External URL: `/v1/viewing-requests/{id}`. Current Next.js implementation path: `/api/platform/v1/viewing-requests/[id]`. This read-only route does not require `Idempotency-Key` and never exposes contact details or partner routing metadata.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Correlation-Id` string

## Response `200`

Viewing request status.

- ViewingRequestStatusResponse
  - `viewing_request` object, required
    - `id` string, uuid, required
    - `listing_id` string, required
    - `status` 'pending' | 'accepted' | 'declined' | 'cancelled' | 'completed' | 'no_show' | 'expired', required
    - `environment` 'sandbox' | 'live', required
    - `submitted_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `livemode` boolean, 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)