# Get Transition Status

`GET /custody-mode-transition/{job_id}` · Keys & Secrets · Custody & Exit

Returns a custody transition job's state.

## Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `projectId` | query | yes | The project's id. Example: `"3f2c9a4e-8b1d-4c6f-9e2a-7d5b1c0a4e8f"`. |
| `job_id` | path | yes | The transition job's id, as Start Custody Transition returned it: `ctjob_` and a UUID. Example: `"ctjob_6f1d2c3b-9a8e-4b7c-8d6e-5f4a3b2c1d0e"`. |

## Responses

- **200**: The job's state.

| Field | Type | Required | Description |
|---|---|---|---|
| `completedAt` | string (date-time) \| null | no | Transition completion timestamp; `null` while in progress. The database time of the completing transaction, identical on the POST answer, the poll and `GET /vault`. Example: `"2026-11-15T09:30:00.123Z"`. |
| `completedSeq` | integer (int64) \| null | no | The project's completed jobs in strictly increasing order. Compare jobs on this, never on `completedAt` or `jobId`. Absent until the job completes. Example: `12`. |
| `error` | object | no |  |
| _one of_ | | |  |
| _or_ | | |  |
| `error.code` | string | yes | Machine-readable error code. Example: `"BYOK_KEY_UNREACHABLE"`. |
| `error.message` | string | yes | Human-readable error message. Example: `"The customer KMS key could not be reached."`. |
| `fromMode` | enum ("PLATFORM_MANAGED", "CONFIDENTIAL_WORKLOAD", "BYOK", "HYOK") | yes | Custody mode of a project's vault. |
| `jobId` | string | yes | Job identifier — UUID prefixed `"ctjob_"`. Example: `"ctjob_7c9e6679-7425-40de-944b-e07fc1f90ae7"`. |
| `projectId` | string | yes | Project this transition is for. Example: `"3f2b8c1e-5d4a-4e6f-9a7b-1c2d3e4f5a6b"`. |
| `rekeyProgress` | number (double) | yes | Re-key progress (0.0 .. 1.0); meaningful only when `rekey_required == true`. Example: `1`. |
| `rekeyRequired` | boolean | yes | Whether a re-key is required for this transition. Example: `true`. |
| `restoreEpoch` | string \| null | no | The id of the last restore this kibo came back from, or null if it was never restored. When it changes, `completedSeq` numbering started again. Example: `"rfn_3Hk8Pz2Qw7Ln"`. |
| `restoreGeneration` | integer (int64) \| null | no | The ordered `restoreGeneration` of that episode (the HWM its lift published to the external witness); a gateway accepts a watermark reset only for a GREATER one. Example: `2`. |
| `startedAt` | string (date-time) | yes | Transition start timestamp. Example: `"2026-11-01T08:00:00.000Z"`. |
| `status` | enum ("in_progress", "complete", "failed") | yes | Custody-mode-transition job lifecycle status. |
| `toMode` | enum ("PLATFORM_MANAGED", "CONFIDENTIAL_WORKLOAD", "BYOK", "HYOK") | yes | Custody mode of a project's vault. |


## Errors

| HTTP | Description |
|---|---|
| 401 | The request carries no authenticated caller. |
| 404 | No such transition job. |
| 500 | An internal error. Retry later. |

## Code samples

### cURL

```bash
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/custody-mode-transition/<jobId>' \
  -H 'Authorization: Bearer $K9O_TOKEN'
```

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/@storefront/custody-mode-transition/<jobId>', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.K9O_TOKEN}`
  },
});
const { data, meta } = await res.json();
```


Canonical page: https://docs.kilimanjaro.dev/api-playground/keys-secrets/get-transition-status
