Skip to main content
GET
Get plan move
Read a move of subscribers between plan versions with each subscriber’s status: moving, moved, needs a change, left out, canceled or kept on its version.

Authorizations

x-api-key
string
header
required

Headers

Commet-Version
string
default:2026-08-27

API version used by this reference. Send this header to select this contract explicitly.

Path Parameters

id
string
required
moveId
string
required

Response

Success

id
string | null
required

Public move ID. Null for a preview, which records nothing.

toVersionId
string
required
fromVersionIds
string[]
required

The versions its subscribers are moving from.

effective
enum<string>
required
Available options:
now,
period_end
preview
boolean
required
status
enum<string>
required

checked is a preview where everyone fits; moving while subscribers wait for their move; completed once every move ran; canceled after it was canceled.

Available options:
checking,
blocked,
checked,
moving,
completed,
canceled
counts
object
required
subscriptions
object[]
required
createdAt
string<date-time> | null
required
completedAt
string<date-time> | null
required
canceledAt
string<date-time> | null
required
object
string
required
Allowed value: "plan_move"
livemode
boolean
required