---
title: "Read Community"
method: GET
path: "/v1/community/{community_id}"
tags: ["Community"]
---

# Read Community

`GET /v1/community/{community_id}`

Get data for a specific community.

Returns the full `Community` schema to platform admins and the community's
own admins. All other callers (including unauthenticated) receive a
reduced `Community_Public` schema that omits PII (email, phone), internal
CRM ids, consent audit trail, feature flags, Spydus credentials, and the
arbitrary `config` dict.

## Path parameters

- `community_id` integer, required

## Headers

- `X-Access-Token` string, nullable

## Response `200`

Successful Response

- union
  - Community
    - `name` string, nullable
    - `short_name` string, nullable
    - `organisation_name` string, nullable
    - `company_number` string, nullable
    - `verification_url` string, nullable
    - `type` 'City' | 'Region' | 'Local_Authority' | 'Membership_Organisation' | 'Awarding_Body' | 'Partnership' | 'Corporate' | 'Association' | 'University' | 'College' | 'Charity' | 'Other'
    - `description` string, nullable
    - `email` string, email, nullable
    - `phone` string, nullable
    - `address` string, nullable
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `city` string, nullable
    - `country` string, nullable
    - `is_default` boolean, nullable
    - `external_url` string, nullable
    - `image_url` string, nullable
    - `banner_url` string, nullable
    - `image_url_2x` string, nullable
    - `banner_url_2x` string, nullable
    - `image_url_original` string, nullable
    - `banner_url_original` string, nullable
    - `featured` boolean, nullable
    - `colour` string, nullable
    - `enable_summary_emails` boolean, nullable
    - `linkedin_organisation_id` integer, nullable
    - `social_handle_linkedin` string, nullable
    - `social_handle_twitter` string, nullable
    - `social_handle_facebook` string, nullable
    - `social_handle_instagram` string, nullable
    - `consent_supply_of_service` string, date-time, nullable
    - `consent_supply_of_service_by` integer, nullable
    - `pipedrive_org_id` integer, nullable
    - `pipedrive_deal_id` integer, nullable
    - `id` integer
    - `status` 'Active' | 'Suspended' | 'Deleted'
    - `seo_keywords` string[], nullable
    - `seo_title` string, nullable
    - `seo_description` string, nullable
    - `enable_engagement_emails` boolean, nullable
    - `ranking` integer, nullable
    - `created_by_id` integer, nullable
    - `updated_by_id` integer, nullable
    - `verified_by_id` integer, nullable
    - `verification_request_by_id` integer, nullable
    - `time_created` string, date-time
    - `time_updated` string, date-time, nullable
    - `time_verified` string, date-time, nullable
    - `time_stats_email_sent` string, date-time, nullable
    - `postal_address` Address
      - `full_address` string, nullable
      - `name` string, nullable
      - `number` string, nullable
      - `street` string, nullable
      - `postcode` string, nullable
      - `locality` string, nullable
      - `city` string, nullable
      - `district` string, nullable
      - `region` string, nullable
      - `country` string, nullable
    - `config` unknown
    - `survey_consent` string, nullable
    - `is_demo` boolean, nullable
    - `is_verified` boolean, nullable
    - `verification_text` string, nullable
    - `verification_email` string, email, nullable
    - `enable_analytics` boolean, nullable
    - `enable_members` boolean, nullable
    - `enable_library_card` boolean, nullable
    - `spydus_library_url` string, nullable
    - `referral_code` string, nullable
    - `url` string, nullable
  - CommunityPublic
    - `id` integer
    - `status` 'Active' | 'Suspended' | 'Deleted'
    - `type` 'City' | 'Region' | 'Local_Authority' | 'Membership_Organisation' | 'Awarding_Body' | 'Partnership' | 'Corporate' | 'Association' | 'University' | 'College' | 'Charity' | 'Other'
    - `name` string, nullable
    - `short_name` string, nullable
    - `description` string, nullable
    - `external_url` string, nullable
    - `address` string, nullable
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `is_verified` boolean, nullable
    - `verification_text` string, nullable
    - `verification_url` string, nullable
    - `is_demo` boolean, nullable
    - `colour` string, nullable
    - `spydus_library_url` string, nullable
    - `referral_code` string, nullable
    - `image_url` string, nullable
    - `banner_url` string, nullable
    - `image_url_2x` string, nullable
    - `banner_url_2x` string, nullable
    - `image_url_original` string, nullable
    - `banner_url_original` string, nullable
    - `linkedin_organisation_id` integer, nullable
    - `social_handle_linkedin` string, nullable
    - `social_handle_twitter` string, nullable
    - `social_handle_facebook` string, nullable
    - `social_handle_instagram` string, nullable
    - `seo_title` string, nullable
    - `seo_description` string, nullable
    - `seo_keywords` string[], nullable
    - `url` string, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `410` — Gone
- `422` — Unprocessable Content

---

[API](https://skmtc.net/navigatr/apis/navigatr-api.md) · [All operations](https://skmtc.net/navigatr/apis/navigatr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/navigatr/navigatr-api/revisions/4039d06e340b/schema)
