---
title: "List sandbox valuation and appraisal cases"
method: GET
path: "/valuation-appraisal/current/cases"
tags: ["Valuation and appraisal"]
---

# List sandbox valuation and appraisal cases

`GET /valuation-appraisal/current/cases`

## Request

- Base URL: `https://platform-api.homejourney.sg/v1`
- URL: `https://platform-api.homejourney.sg/v1/valuation-appraisal/current/cases`
- Auth: HTTP bearer

Returns deterministic sandbox case, property-fact, comparable-evidence, inspection, professional-review, and handoff summaries when the authenticated automation client has `valuation_appraisal.cases.read`. External URL: `/v1/valuation-appraisal/current/cases`. Current Next.js implementation path: `/api/platform/v1/valuation-appraisal/current/cases`. This read-only route does not require `Idempotency-Key` and never exposes exact addresses, unit identifiers, ownership identity, client or lender contacts, access instructions, raw comparable records, adjustment notes, raw reports, credentials, write controls, or live provider integrations. Official valuation records, inspection scheduling, report issuance, client or lender handoffs, and comparable-evidence writes remain explicitly deferred and professional review is always required.

## Headers

- `X-Correlation-Id` string

## Response `200`

Minimized sandbox valuation and appraisal cases.

- ValuationAppraisalCaseListResponse
  - `cases` ValuationAppraisalCase[], required
    - `id` string, required
    - `fixture_id` string, required
    - `display_label` string, required
    - `case_status` 'evidence_review' | 'inspection_review' | 'professional_review', required
    - `valuation_purpose` 'mortgage_security' | 'sale_advice' | 'portfolio_review', required
    - `property_facts` object, required
      - `asset_type` 'residential_apartment' | 'landed_residential' | 'commercial_unit', required
      - `tenure` 'freehold' | 'leasehold', required
      - `planning_area` string, required
      - `exact_address_exposed` false, required
      - `unit_identifier_exposed` false, required
      - `ownership_identity_exposed` false, required
    - `comparable_evidence` object, required
      - `comparable_count` integer, required
      - `evidence_period` string, required
      - `source_label` string, required
      - `source_records_exposed` false, required
      - `adjustment_notes_exposed` false, required
    - `inspection` object, required
      - `status` 'not_scheduled' | 'scheduled' | 'completed', required
      - `access_instructions_exposed` false, required
      - `occupant_identity_exposed` false, required
    - `professional_review` object, required
      - `required` true, required
      - `status` 'pending_registered_valuer_review' | 'review_in_progress' | 'review_complete', required
      - `automated_official_valuation` false, required
    - `handoff` object, required
      - `audience` 'client' | 'lender' | 'owner', required
      - `status` 'not_sent' | 'ready_for_professional_review' | 'professionally_released', required
      - `recipient_identity_exposed` false, required
      - `report_document_exposed` false, required
    - `source_attribution` object, required
      - `source_type` 'sandbox_fixture', required
      - `freshness_status` 'current', required
      - `fixture_updated_at` string, date-time, required
    - `redaction` object, required
      - `exact_address_exposed` false, required
      - `client_or_lender_contact_exposed` false, required
      - `raw_reports_exposed` false, required
      - `access_instructions_exposed` false, required
      - `credentials_exposed` false, required
    - `side_effects` object, required
      - `official_valuation_record_created` false, required
      - `inspection_scheduled` false, required
      - `valuation_report_issued` false, required
      - `client_or_lender_handoff_sent` false, required
      - `comparable_evidence_mutated` false, required
      - `live_callback_sent` false, required
  - `access` object, required
    - `organization_id` string, uuid, required
    - `client_id` string, uuid, required
    - `granted_scopes` PlatformScope[], required
    - `sandbox_fixture_mode` 'read_only', required
    - `live_case_reads` 'deferred', required
    - `blocked_actions` string[], 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)