---
title: "List current provider integration directory metadata"
method: GET
path: "/providers/current/integrations"
tags: ["Provider integrations"]
---

# List current provider integration directory metadata

`GET /providers/current/integrations`

## Request

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

Returns read-only connected-app directory metadata for current provider workspaces when the authenticated automation client has `provider_workspace.read`. External URL: `/v1/providers/current/integrations`. Current Next.js implementation path: `/api/platform/v1/providers/current/integrations`. This read-only route does not require `Idempotency-Key`; it exposes contract metadata, redacted credential posture, sync health, support owner, source-mode, certification, and deferred action availability only. It never returns raw credentials, OAuth tokens, webhook secrets, raw sync payloads, customer PII, direct external-system calls, install mutations, pause/resume mutations, or revocation mutations.

## Headers

- `X-Correlation-Id` string

## Response `200`

Current provider integration directory metadata.

- ProviderIntegrationsDirectoryResponse
  - `modules` ProviderIntegrationModule[], required
    - `module_id` 'agent' | 'agency' | 'business' | 'mortgage' | 'legal' | 'developer' | 'renovation', required
    - `label` string, required
    - `workspace_root` string, required
    - `directory_categories` string[], required
    - `source_mode_default` 'homejourney_source_of_truth', required
    - `sync_layer_blocked_until` string[], required
    - `install_api_prerequisites_satisfied` boolean, required
    - `install_api_runtime_boundary` 'runtime_app_install_routes_deferred_until_prerequisites_pass', required
    - `apps` ProviderIntegrationApp[], required
      - `app_id` string, required
      - `owner` string, required
      - `verticals` string[], required
      - `categories` string[], required
      - `required_scopes` PlatformScope[], required
      - `data_categories` string[], required
      - `credential_type` 'none' | 'oauth' | 'api_key_digest' | 'webhook_secret_digest' | 'managed_service_account', required
      - `credential_posture` 'redacted_api_key_digest_visible' | 'webhook_secret_digest_visible' | 'oauth_or_service_account_visible' | 'not_required', required
      - `webhook_event_count` integer, required
      - `webhook_endpoint_posture` 'sandbox_webhook_endpoint_visible' | 'webhook_endpoint_not_required', required
      - `sync_mode` 'read_only' | 'write_with_confirmation' | 'webhook' | 'batch_import' | 'manual_export', required
      - `certification_status` 'deferred' | 'sandbox_certified' | 'live_review' | 'live_certified' | 'revoked', required
      - `install_eligibility` 'public_catalog' | 'invite_only' | 'operator_review' | 'unsupported', required
      - `contract_lifecycle_state` 'sandbox_installed' | 'live_review' | 'deferred', required
      - `sync_health` 'healthy' | 'review_required' | 'deferred', required
      - `adapter_posture` 'local_gate_ready_pending_release' | 'deferred_adapter_state_visible' | 'unsupported_adapter_state_visible', required
      - `cli_support_posture` 'local_gate_ready_pending_release', required
      - `mcp_support_posture` 'local_gate_ready_pending_release', required
      - `last_sync_at` string, date-time, nullable, required
      - `last_error_at` string, date-time, nullable, required
      - `action_availability` ProviderIntegrationActionAvailability, required
        - `install` 'deferred_until_install_route', required
        - `pause` 'deferred_until_mutation_route', required
        - `resume` 'deferred_until_mutation_route', required
        - `revoke` 'deferred_until_mutation_route', required
      - `revoke_action` 'fanout_api_key_webhook_mcp_and_connected_app_grants', required
      - `support_owner` string, required
  - `summary` ProviderIntegrationsSummary, required
    - `total_modules` integer, required
    - `total_app_surfaces` integer, required
    - `unique_apps` integer, required
    - `sandbox_certified_surfaces` integer, required
    - `live_review_surfaces` integer, required
    - `deferred_surfaces` integer, required
    - `install_mutations` 'deferred_until_install_routes', required
    - `source_contract` 'vertical_apps_integration_surface', required
  - `authorization` ProviderIntegrationsAuthorization, required
    - `organization_id` string, uuid, required
    - `client_id` string, uuid, required
    - `api_key_id` string, uuid, required
    - `required_scope` 'provider_workspace.read', required
    - `granted_provider_scopes` PlatformScope[], required
    - `actor_model` 'api_key_automation_client', required
    - `data_access` 'contract_metadata_only', required
    - `mutation_access` 'install_pause_resume_revoke_deferred', required
  - `public_safety` ProviderIntegrationsPublicSafety, required
    - `raw_credentials_returned` false, required
    - `oauth_tokens_returned` false, required
    - `webhook_secrets_returned` false, required
    - `customer_pii_returned` false, required
    - `raw_sync_payloads_returned` false, required
    - `direct_external_system_calls` false, required
    - `install_or_revocation_mutations_enabled` false, required
  - `principal` Principal, required (unresolved $ref)
  - `livemode` boolean, 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)