---
title: "Inspect current sandbox agent distribution status"
method: GET
path: "/agents/current/distribution"
tags: ["Agents"]
---

# Inspect current sandbox agent distribution status

`GET /agents/current/distribution`

## Request

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

Returns public-safe sandbox distribution status for the current sandbox agent when the authenticated automation client has `agent.distribution.read`. External URL: `/v1/agents/current/distribution`. Current Next.js implementation path: `/api/platform/v1/agents/current/distribution`. This read-only route does not require `Idempotency-Key`; SDK, CLI, and MCP distribution inspection may call this sandbox route while live distribution, distribution activation, channel reconfiguration, lead counts, customer PII, owner contact, raw channel configuration, and delegated agency actors remain deferred.

## Headers

- `X-Correlation-Id` string

## Response `200`

Current sandbox agent public-safe distribution status.

- CurrentAgentDistributionResponse
  - `distribution` object, required: Public-safe sandbox distribution status for the current sandbox agent. Lead counts, customer PII, owner contact fields, contact exports, routing data, raw channel configuration, and distribution controls are not returned.
    - `agent_id` string, required
    - `summary` object, required
      - `total_listings` integer, required
      - `active_listings` integer, required
      - `draft_listings` integer, required
      - `active_channels` integer, required
      - `pending_channels` integer, required
      - `paused_channels` integer, required
      - `failed_channels` integer, required
      - `lead_counts_returned` false, required
    - `listings` object[], required
      - `listing_id` string, required
      - `title` string, required
      - `agent_listing_status` 'active' | 'draft', required
      - `distribution_state` 'active' | 'unpublished', required
      - `eligibility` object, required
        - `eligible` boolean, required
        - `blockers` string[], required
        - `source` 'sandbox_fixture', required
      - `channels` object[], required
        - `channel_id` string, required
        - `channel_name` string, required
        - `display_name` string, required
        - `channel_type` 'homejourney' | 'partner_portal' | 'social' | 'mls', required
        - `status` 'active' | 'pending_review' | 'paused' | 'failed', required
        - `syndicated_at` string, date-time, nullable, required
        - `paused_at` string, date-time, nullable, required
        - `failure_code` string, nullable, required
        - `lead_count_returned` false, required
        - `lead_count` unknown, required
      - `actions` object, required
        - `allowed` string[], required
        - `blocked` string[], required
    - `public_safety` object, required
      - `channel_status_returned` true, required
      - `lead_counts_returned` false, required
      - `customer_pii_returned` false, required
      - `owner_contact_returned` false, required
      - `contact_export_returned` false, required
      - `routing_data_returned` false, required
      - `raw_channel_config_returned` false, required
      - `distribution_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)