---
title: "Inspect the recipient data-sharing center"
method: GET
path: "/data-sharing/center"
tags: ["Consent and data sharing"]
---

# Inspect the recipient data-sharing center

`GET /data-sharing/center`

## Request

- Base URL: `https://platform-api.homejourney.sg/v1`
- URL: `https://platform-api.homejourney.sg/v1/data-sharing/center`
- Auth: HTTP bearer

Returns an aggregate view of the grants and document shares where the authenticated organization is the recipient, plus summary counts. Requires `consents.read`. External URL: `/v1/data-sharing/center`. Current Next.js implementation path: `/api/platform/v1/data-sharing/center`. This read-only route does not require `Idempotency-Key`.

## Headers

- `X-Correlation-Id` string

## Response `200`

Recipient data-sharing center.

- PlatformDataSharingCenterResponse
  - `center` object, required
    - `recipient_organization_id` string, uuid, required
    - `grants` PlatformConsentResource[], required
      - `id` string, uuid, required
      - `environment` 'sandbox' | 'live', required
      - `subject_user_id` string, uuid, required
      - `recipient_type` 'ai_host' | 'marketplace_app' | 'bank' | 'law_firm' | 'agent' | 'agency' | 'service_provider' | 'developer' | 'official_source_operator' | 'internal_operator', required
      - `recipient_organization_id` string, uuid, nullable
      - `recipient_app_id` string, nullable
      - `recipient_client_id` string, uuid, nullable
      - `scope` string, required
      - `data_category` string, required
      - `purpose` string, required
      - `purpose_version` string, required
      - `consent_text_version` string, required
      - `source_channel` string, required
      - `grant_status` 'active' | 'expired' | 'revoked' | 'superseded' | 'suspended', required
      - `is_active` boolean, required
      - `last_used_at` string, date-time, nullable
      - `expires_at` string, date-time, nullable
      - `revoked_at` string, date-time, nullable
      - `revocation_reason` string, nullable
      - `superseded_by_grant_id` string, uuid, nullable
      - `retention_until` string, date-time, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `document_shares` PlatformDocumentShareResource[], required
      - `id` string, uuid, required
      - `environment` 'sandbox' | 'live', required
      - `grant_id` string, uuid, required
      - `subject_user_id` string, uuid, required
      - `recipient_type` 'ai_host' | 'marketplace_app' | 'bank' | 'law_firm' | 'agent' | 'agency' | 'service_provider' | 'developer' | 'official_source_operator' | 'internal_operator', required
      - `recipient_organization_id` string, uuid, nullable
      - `recipient_client_id` string, uuid, nullable
      - `document_label` string, required
      - `data_category` string, required
      - `purpose` string, required
      - `manifest_summary` object, required
      - `share_status` 'active' | 'expired' | 'revoked' | 'superseded' | 'suspended', required
      - `handoff_url_ttl_seconds` integer, required
      - `last_handoff_at` string, date-time, nullable
      - `expires_at` string, date-time, required
      - `revoked_at` string, date-time, nullable
      - `revocation_reason` string, nullable
      - `retention_until` string, date-time, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `summary` object, required
      - `total_grants` integer, required
      - `active_grants` integer, required
      - `revoked_grants` integer, required
      - `document_shares` integer, required
      - `active_document_shares` integer, required
  - `public_safety` PlatformConsentPublicSafety, required: Redaction guarantees applied to every consent response.
    - `consent_text_returned` false, required
    - `raw_user_pii_returned` false, required
    - `internal_audit_ids_returned` false, required
    - `recipient_billing_returned` false, required
  - `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)