---
title: "Get organization details by external Id"
method: GET
path: "/api/v1/organizations:external/{external_id}"
tags: ["Organizations"]
---

# Get organization details by external Id

`GET /api/v1/organizations:external/{external_id}`

Retrieves organization details by external ID, including name, region, metadata, and settings. Only provide external_id in the path. If the id query parameter is also supplied, it silently takes precedence over external_id due to protobuf oneof semantics, which causes the request to fail with a 400 Bad Request ('ExternalId is required').

## Path parameters

- `external_id` string, required

## Query parameters

- `id` string

## Response `200`

Returns the complete organization object with ID, display name, settings, external ID and metadata

- OrganizationsGetOrganizationResponse
  - `organization` OrganizationsOrganization
    - `create_time` string, date-time, required — Timestamp when the organization was created
    - `display_name` string — Name of the organization. Must be between 1 and 200 characters
    - `external_id` string — Your application's unique identifier for this organization, used to link Scalekit with your system.
    - `id` string — Unique scalekit-generated identifier that uniquely references an organization
    - `logo_url` string, uri — HTTPS URL of the organization's logo image. Maximum 1024 characters. Must use the https scheme.
    - `metadata` object — Key value pairs extension attributes.
    - `region_code` 'US' | 'EU'
    - `settings` OrganizationsOrganizationSettings — Configuration options that control organization-level features and capabilities
      - `features` OrganizationsOrganizationSettingsFeature[] — List of feature toggles that control organization capabilities such as SSO authentication and directory synchronization
        - `enabled` boolean, required — Whether the feature is enabled (true) or disabled (false) for this organization
        - `name` string, required — Feature identifier. Supported values include: "sso" (Single Sign-On), "directory_sync" (Directory Synchronization), "domain_verification" (Domain Verification), "session_policy" (Organization-level session policy override)
    - `slug` string — Slug for dynamic redirect URI resolution. A single DNS label (e.g. acme) or hostname (e.g. oauth.pstmn.io). Lowercase alphanumeric, hyphens, and dots. Max 253 chars. Unique per environment.
    - `update_time` string, date-time — Timestamp when the organization was last updated

## Other responses

- `400` — Invalid request - external ID is empty or the caller's organization claim does not match
- `404` — Organization not found - no organization exists with the specified external ID

---

[API](https://skmtc.net/scalekit/apis/scalekit-api-reference.md) · [All operations](https://skmtc.net/scalekit/apis/scalekit-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalekit/scalekit-api-reference/versions/a40d5d4650e5/schema)