---
title: "Get extant"
method: GET
path: "/v1/organizations"
tags: ["Organizations"]
---

# Get extant

`GET /v1/organizations`

Gets user's associated organizations basic information.

## Query parameters

- `basic_info` boolean
- `exclude_inherit_privacy_mode` boolean
- `managed_by_msp_id` integer
- `name` string
- `owned_msp_id` integer
- `page` object
  - `number` integer
  - `size` integer
- `pii_grid_search` string
- `type` 'normal' | 'msp' | 'sub_organization'

## Response `200`

Organizations basic information

- object
  - `data` OrganizationSpec[]
    - `id` string — Resource Id (integer or uuid)
    - `type` string — Resource type name
    - `uuid` string — Resource UUID (if applicable)
    - `attributes` Organization — Organization resource
      - `id` integer — ID
      - `address` string — Organization legal address
      - `allow_create_network` boolean — Current user can create new networks in the organization
      - `allowlist_updated_at` string, date-time — The datetime the allow list was last updated
      - `billing_address` string — The organization's billing address
      - `billing_contact_email` string — Contact email
      - `billing_contact_name` string — Contact name
      - `billing_contact_phone` string — Contact phone
      - `billing_manual` boolean — Internal Use Only
      - `blocklist_updated_at` string, date-time — The datetime the block list was last updated
      - `canceled` boolean — True if the organization has been canceled
      - `canceled_at` string, date-time — The datetime the organization was canceled
      - `external_id` string — A unique identifier for external integrations
      - `feature_flags` string[] — Allowed features in APP
      - `fetched_onboard_details` boolean — True if organization has provided onboarding details
      - `first_traffic_sent` string, date-time — The datetime the organizations first received DNS network traffic
      - `industry` string — Internal Use Only
      - `managed_by_msp_id` integer — Organization is managed by the specified MSP (may be null)
      - `metadata` string — Internal Use Only
      - `msp_feature_flags` string[] — Allowed features in APP (defined for sub orgs only)
      - `name` string — Organization legal name
      - `owned_msp_id` integer — Organization is owned by an MSP (may be null)
      - `plan_details` string — Internal Use Only
      - `release_channel` string — Internal Use Only
      - `role` string — Role
      - `send_uninstall_notifications_to_admin_users` boolean — Notify admins of uninstall notifications
      - `sso_enabled` boolean — Organization's SSO status
      - `stripe_customer_id` string — Stripe ID
      - `summary_email_address` string — The email to send the weekly summary of activity email
      - `summary_email_enabled` boolean — True if the weekly summary of activity email should be sent
      - `sync_tools_auto_update` string — Internal Use Only
      - `trial_days` integer — Number of trial days (may be null)
      - `unbounce_data` string — Internal Use Only
      - `unique_id` string — A globally unique value among all organizations
      - `update_payment` boolean — Organization has a valid payment method associated
      - `usage_alert_cents` string — Internal Use Only
      - `user_agent_uninstall_notification` boolean — Notify recipients when user agent is uninstalled
      - `user_agent_uninstall_notification_recipient_emails` string[] — Recipients to receive uninstalled user agent notifications
      - `user_agents_auto_update` boolean — True if user agents will auto update
      - `will_cancel_at` string, date-time — The datetime the organization will be canceled
      - `active_psa_integration` boolean — Organization has an active PSA integration
      - `segment` string — Internal Use Only
      - `vpn_settings_organization` object — Vpn organization settings
        - `vpn_settings_state_type_id` integer
    - `relationships` object — Network associated resources
      - `networks` object
        - `data` IdType[]
          - `id` string — Resource Id (integer or uuid)
          - `type` string — Resource type name
          - `uuid` string — Resource UUID (if applicable)
  - `links` Links — JSON API links member representation
    - `self` string — Endpoint URL (may be null)

## Other responses

- `401` — Unauthorized

---

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