Skip to main content
GET
/
api
/
v1
/
safe
/
migration
Retrieve Safe migration status
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.gnosispay.com/api/v1/safe/migration', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "migrationId": "safe-replacement-2026-06",
  "hasOldSafe": true,
  "newSafe": {
    "address": "0xabcdef1234567890abcdef1234567890abcdef12",
    "chainId": "100",
    "tokenSymbol": "EURe"
  },
  "oldSafe": {
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "chainId": "100",
    "recordedAt": "2026-06-03T12:00:00.000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gnosispay.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
migrationId
string
default:safe-replacement-2026-06

Migration identifier to look up.

Response

Successfully retrieved safe migration info.

​
migrationId
string
required
Example:

"safe-replacement-2026-06"

​
hasOldSafe
boolean
required

Whether a previous safe was recorded for this migration.

​
status
enum<string> | null

Migration status, or null if the user has not started this migration.

Available options:
PENDING,
IN_PROGRESS,
COMPLETED,
FAILED
​
newSafe
object

The user's current active safe.

​
oldSafe
object

The previous safe recorded during migration, if any.