---
title: "List sandbox partner site forms"
method: GET
path: "/sites/{id}/forms"
tags: ["Sites"]
---

# List sandbox partner site forms

`GET /sites/{id}/forms`

## Request

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

Returns deterministic sandbox partner-site form metadata when the authenticated automation client has `forms.read`. External URL: `/v1/sites/{id}/forms`. Current Next.js implementation path: `/api/platform/v1/sites/[id]/forms`. This read-only route does not require `Idempotency-Key`; it returns form metadata only and never returns submissions, exposes recipient destinations, renders public forms, publishes sites, writes CRM records, performs scheduling side effects, configures custom domains, calls providers, or exposes partner secrets. Live site form reads remain unavailable until ownership, consent, delivery, and route-promotion gates pass.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Headers

- `X-Correlation-Id` string

## Response `200`

Sandbox partner-site forms.

- PlatformSiteFormsResponse
  - `site` PlatformSiteSummary, required
    - `id` string, required
    - `sandbox_fixture_id` string, required: Deterministic sandbox fixture ID; live site IDs remain unavailable.
    - `site_slug` string, required
    - `display_name` string, required
    - `owner_type` 'individual_agent' | 'agency_organization' | 'service_provider' | 'mortgage_partner' | 'platform_ops', required
    - `template_id` 'agency_microsite' | 'agent_landing_page' | 'service_provider_landing_page' | 'mortgage_partner_lead_page', required
    - `template_version` string, required
    - `site_status` 'draft' | 'review_requested' | 'approved' | 'published' | 'paused' | 'takedown_pending' | 'retracted' | 'archived', required
    - `public_route_path` string, nullable, required
    - `custom_domain_status` 'deferred', required
    - `content_safety_status` 'passed', required
    - `allowed_origins` string[], required
    - `updated_at` string, date-time, required
    - `livemode` false, required
  - `forms` PlatformSiteFormSummary[], required
    - `id` string, required
    - `sandbox_fixture_id` string, required
    - `site_id` string, required
    - `page_ids` string[], required: Sandbox page IDs where the form metadata is attached.
    - `form_slug` string, required
    - `title` string, required
    - `form_type` 'contact' | 'valuation' | 'mortgage_preapproval' | 'service_interest', required
    - `publication_status` 'draft' | 'review_requested' | 'approved' | 'published' | 'paused' | 'takedown_pending' | 'retracted' | 'archived', required
    - `consent_text_version` string, required
    - `recipient_routing` 'redacted', required
    - `submission_storage` 'deferred', required
    - `crm_delivery` 'deferred', required
    - `content_safety_status` 'passed', required
    - `side_effects` PlatformSiteSideEffects, required
      - `email_sent` false, required
      - `sms_sent` false, required
      - `whatsapp_sent` false, required
      - `crm_write_performed` false, required
      - `calendar_write_performed` false, required
      - `payment_created` false, required
      - `distribution_mutated` false, required
      - `provider_call_performed` false, required
    - `livemode` false, required
    - `updated_at` string, date-time, required
  - `pagination` object, required
    - `limit` integer, required
    - `next_cursor` string, nullable, 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)