---
title: "List the current sandbox agency roster"
method: GET
path: "/agencies/current/roster"
tags: ["Agencies"]
---

# List the current sandbox agency roster

`GET /agencies/current/roster`

## Request

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

Returns public-safe sandbox roster data for the current sandbox agency when the authenticated automation client has `agency.roster.read`. External URL: `/v1/agencies/current/roster`. Current Next.js implementation path: `/api/platform/v1/agencies/current/roster`. This read-only route does not require `Idempotency-Key`; SDK, CLI, and MCP roster inspection may call this sandbox route, while live agency identity, delegated impersonation, contact fields, private notes, raw lead data, raw client data, identity documents, subscription receipts, billing identifiers, CRM secrets, contact exports, and write controls remain deferred.

## Headers

- `X-Correlation-Id` string

## Response `200`

Public-safe sandbox agency roster.

- CurrentAgencyRosterResponse
  - `roster` object, required: Public-safe sandbox agency roster. Contact fields, private notes, raw lead data, raw client data, identity documents, subscription receipts, billing identifiers, CRM secrets, contact exports, and write controls are not returned.
    - `agency` object, required
      - `id` string, required
      - `name` string, required
      - `registration_number` string, required
      - `status` 'sandbox_active', required
      - `environment` 'sandbox_fixture', required
    - `summary` object, required
      - `total_agents` integer, required
      - `active_cea_agents` integer, required
      - `expired_cea_agents` integer, required
      - `teams` integer, required
      - `branches` integer, required
      - `assistants` integer, required
      - `crm_integrations` integer, required
      - `contact_fields_returned` false, required
      - `private_notes_returned` false, required
      - `identity_documents_returned` false, required
    - `branches` object[], required
      - `branch_id` string, required
      - `name` string, required
      - `region` 'central' | 'east', required
      - `team_ids` string[], required
    - `teams` object[], required
      - `team_id` string, required
      - `branch_id` string, required
      - `name` string, required
      - `lead_agent_id` string, required
      - `member_agent_ids` string[], required
      - `assistant_ids` string[], required
    - `agents` object[], required
      - `agent_id` string, required
      - `display_name` string, required
      - `cea_registration_number` string, required
      - `cea_status` 'verified' | 'expired', required
      - `singpass_verified` boolean, required
      - `branch_id` string, required
      - `team_ids` string[], required
      - `role` 'salesperson', required
      - `allowed_actions` string[], required
      - `blocked_actions` string[], required
    - `assistants` object[], required
      - `assistant_id` string, required
      - `display_role` 'operations_assistant' | 'crm_assistant', required
      - `assigned_team_ids` string[], required
      - `delegated` false, required
      - `allowed_actions` string[], required
    - `integrations` object[], required
      - `integration_client_id` string, required
      - `name` string, required
      - `status` 'sandbox_only', required
      - `scopes` PlatformScope[], required
      - `delegated_impersonation_allowed` false, required
    - `public_safety` object, required
      - `contact_fields_returned` false, required
      - `private_notes_returned` false, required
      - `customer_pii_returned` false, required
      - `raw_lead_data_returned` false, required
      - `raw_client_data_returned` false, required
      - `identity_documents_returned` false, required
      - `subscription_receipts_returned` false, required
      - `billing_identifiers_returned` false, required
      - `crm_secrets_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_agency_scopes` PlatformScope[], required
    - `actor_model` 'api_key_automation_client', required
    - `live_agency_identity` 'deferred', required
    - `delegation_model` 'explicit_delegation_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)