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

# List current sandbox agent clients

`GET /agents/current/clients`

## Request

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

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

## Headers

- `X-Correlation-Id` string

## Response `200`

Current sandbox agent public-safe client relationship status.

- CurrentAgentClientsResponse
  - `clients` object, required: Public-safe sandbox client relationship status for the current sandbox agent. Client names, customer PII, contact fields, private notes, raw messages, financial documents, identity documents, owner contact fields, routing data, contact exports, and write controls are not returned.
    - `agent_id` string, required
    - `summary` object, required
      - `total_clients` integer, required
      - `active_clients` integer, required
      - `nurturing_clients` integer, required
      - `dormant_clients` integer, required
      - `contact_fields_returned` false, required
      - `private_notes_returned` false, required
    - `clients` object[], required
      - `client_id` string, required
      - `redacted_client_reference` string, required
      - `relationship_stage` 'active_search' | 'post_viewing_follow_up' | 'nurturing', required
      - `intent` 'buy' | 'rent' | 'sell', required
      - `budget_band` string, required
      - `preferred_property_types` string[], required
      - `preferred_locations` string[], required
      - `linked_listing_ids` string[], required
      - `last_activity_at` string, date-time, required
      - `next_action` 'owned_homejourney_flow_required', required
      - `consent` object, required
        - `contact_allowed` false, required
        - `marketing_allowed` false, required
        - `consent_receipt_returned` false, required
      - `actions` object, required
        - `allowed` string[], required
        - `blocked` string[], required
    - `public_safety` object, required
      - `client_names_returned` false, required
      - `customer_pii_returned` false, required
      - `customer_contact_returned` false, required
      - `private_notes_returned` false, required
      - `raw_message_returned` false, required
      - `financial_documents_returned` false, required
      - `identity_documents_returned` false, required
      - `owner_contact_returned` false, required
      - `routing_data_returned` false, required
      - `contact_export_returned` false, required
      - `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)