---
title: "Get Org Alert Policy Migration Status"
method: GET
path: "/orgs/{org_slug}/alert-policies/migration/status"
tags: ["alert-policies"]
---

# Get Org Alert Policy Migration Status

`GET /orgs/{org_slug}/alert-policies/migration/status`

## Request

- Base URL: `https://api.socket.dev/v0`
- URL: `https://api.socket.dev/v0/orgs/{org_slug}/alert-policies/migration/status`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

Retrieve the alert policy migration status of an organization. This is read-only and does not enroll organizations or start migration windows. Requires a token with org-wide repository access; repo-restricted tokens receive 403.

This endpoint consumes 1 unit of your quota.

This endpoint requires the following org token scopes:
- alert-policy:list

## Path parameters

- `org_slug` string, required

## Response `200`

The alert policy migration status of the organization.

- object
  - `state` 'pending' | 'previewing' | 'accepted' | 'auto_finalized' | 'rolled_back', nullable, required: Current migration state. Null when the organization is not enrolled.
  - `finalized_at` string, nullable, required: ISO-8601 timestamp when migration finalized.
  - `deadline_at` string, nullable, required: ISO-8601 auto-finalization deadline.
  - `window_end_at` string, nullable, required: ISO-8601 end of the organization migration window.
  - `deadline_admin_paused_at` string, nullable, required: ISO-8601 timestamp when an administrator paused the deadline.
  - `alert_policies_enabled` boolean, required: Whether the alert policy layer evaluates for this organization. True for migrated organizations and for organizations that started on Rules & Policies.
  - `legacy_evaluation_enabled` boolean, required: Whether legacy alert triage and the legacy security policy still evaluate for this organization.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Insufficient max_quota for API method
- `404`: Resource not found
- `429`: Insufficient quota for API route

## Changes

- **2026-11-03** `5ad8bf36b1e7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/socket-dev/apis/socket/changes/orgs/:org_slug/alert-policies/migration/status/get.md)

---

[API](https://skmtc.dev/socket-dev/apis/socket.md) - [All operations](https://skmtc.dev/socket-dev/apis/socket/llms.txt) - [OpenAPI document](https://skmtc.dev/socket-dev/apis/socket/revisions/5ad8bf36b1e7?raw)