---
title: "Get organization session policy"
method: GET
path: "/api/v1/organizations/{organization_id}/session-policy"
tags: ["Organizations"]
---

# Get organization session policy

`GET /api/v1/organizations/{organization_id}/session-policy`

Retrieves the session policy for an organization. Returns session_policy='APPLICATION' if the organization inherits the application-level defaults, or session_policy='CUSTOM' with the configured values if a custom policy is active.

## Path parameters

- `organization_id` string, required

## Response `200`

Session policy retrieved successfully.

- OrganizationsGetOrganizationSessionPolicyResponse
  - `policy` OrganizationsOrganizationSessionPolicySettings
    - `absolute_session_timeout` integer — The absolute session timeout value. The unit is specified by absolute_session_timeout_unit. Omitted when policy_source is 'environment'.
    - `absolute_session_timeout_unit` 'MINUTES' | 'HOURS' | 'DAYS'
    - `idle_session_timeout` integer — The idle session timeout value. The unit is specified by idle_session_timeout_unit. Omitted when idle_session_timeout_enabled is false or policy_source is 'environment'.
    - `idle_session_timeout_enabled` boolean — Whether idle session timeout is enabled for this organization. Omitted when policy_source is 'environment'.
    - `idle_session_timeout_unit` 'MINUTES' | 'HOURS' | 'DAYS'
    - `policy_source` 'APPLICATION' | 'CUSTOM'

## Other responses

- `404` — Organization not found.

---

[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)