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

# List current sandbox agent leads

`GET /agents/current/leads`

## Request

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

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

## Headers

- `X-Correlation-Id` string

## Response `200`

Current sandbox agent public-safe lead status.

- CurrentAgentLeadsResponse
  - `leads` object, required: Public-safe sandbox lead status for the current sandbox agent. Customer PII, contact fields, raw messages, private notes, owner contact fields, routing data, contact exports, and write controls are not returned.
    - `agent_id` string, required
    - `summary` object, required
      - `total_leads` integer, required
      - `new_leads` integer, required
      - `contacted_leads` integer, required
      - `qualified_leads` integer, required
      - `archived_leads` integer, required
      - `contact_fields_returned` false, required
    - `leads` object[], required
      - `lead_id` string, required
      - `listing_id` string, required
      - `listing_title` string, required
      - `status` 'new' | 'contacted' | 'qualified' | 'archived', required
      - `source_channel` 'homejourney_sandbox' | 'partner_sandbox' | 'distribution_sandbox', required
      - `created_at` string, date-time, required
      - `redacted_lead_reference` string, required
      - `intent` 'buy' | 'rent' | 'sell', required
      - `budget_band` string, required
      - `timeframe` string, 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
      - `customer_pii_returned` false, required
      - `customer_contact_returned` false, required
      - `private_notes_returned` false, required
      - `raw_message_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)