---
title: "A tenant move's state and plan (Greentally staff only)"
method: GET
path: "/internal/tenant-moves/{moveId}"
tags: ["PlatformOps"]
---

# A tenant move's state and plan (Greentally staff only)

`GET /internal/tenant-moves/{moveId}`

Requires partner.ops.

## Path parameters

- `moveId` string, required

## Response `200`

The move

- TenantMoveResponse
  - `data` TenantMove, required
    - `clerkOrganizationId` string
    - `createdAt` string, date-time
    - `dryRun` boolean, required
    - `error` string — The last failed step's error; cleared when a step succeeds
    - `id` string
    - `mode` 'partner' | 'standalone', required
    - `organizationId` string, required
    - `partnerId` string
    - `plan` object, required — organization, source, target, users (userId, email, name, currentRole, partnerRole, clerkRole), customRoles, pendingInvitations, rowCounts by table, warnings, reason. After the relink it is the plan rebuilt inside the relink transaction, with the row counts it re-pointed.
    - `state` 'planned' | 'clerk_org_created' | 'relinked' | 'members_synced' | 'done' | 'failed', required
    - `targetAccountId` string
    - `updatedAt` string, date-time

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

## Changes

- **2026-10-06** `461a0ebc7731` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greentally/apis/esgai-api/changes/internal/tenant-moves/:moveId/get.md)

---

[API](https://skmtc.dev/greentally/apis/esgai-api.md) · [All operations](https://skmtc.dev/greentally/apis/esgai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/greentally/apis/esgai-api/revisions/461a0ebc7731?raw)