Get Transfer

curl /api/v1/transfers/42 \
  -H "x-api-key: mh_live_abc123..."

curl /api/v1/transfers/by-external/order_12345 \
  -H "x-api-key: mh_live_abc123..."

{
  "id": 42,
  "externalId": "order_12345",
  "status": "processing",
  "phase": "executing",
  "progress": { "hopsCompleted": 3, "hopsTotal": 7 },
  "lastError": null,
  "recovery": null,
  "signatures": {
    "routeInit": ["4mGxFn7m..."],
    "sessionInit": [],
    "hops": ["9rTpWx2a...", "7kLmQv4b..."]
  }
}

{
  "error": {
    "code": "MH_030",
    "message": "Transfer not found"
  }
}

GET

api

transfers

{transferId}

curl /api/v1/transfers/42 \
  -H "x-api-key: mh_live_abc123..."

curl /api/v1/transfers/by-external/order_12345 \
  -H "x-api-key: mh_live_abc123..."

{
  "id": 42,
  "externalId": "order_12345",
  "status": "processing",
  "phase": "executing",
  "progress": { "hopsCompleted": 3, "hopsTotal": 7 },
  "lastError": null,
  "recovery": null,
  "signatures": {
    "routeInit": ["4mGxFn7m..."],
    "sessionInit": [],
    "hops": ["9rTpWx2a...", "7kLmQv4b..."]
  }
}

{
  "error": {
    "code": "MH_030",
    "message": "Transfer not found"
  }
}

Retrieve a transfer by its internal ID. Returns the extended transfer object including phase, progress, recovery, and signatures. A companion endpoint at GET /api/v1/transfers/by-external/{externalId} returns the same response shape using your external ID.

Path parameters

transferId

integer

required

The internal transfer ID.

Response

integer

Transfer ID.

status

string

phase

string

progress

object

Show progress fields

progress.hopsCompleted

integer

Number of hops that have executed.

progress.hopsTotal

integer

Total number of hops in the route.

lastError

object | null

Last error recorded for this transfer, if any.

Show lastError fields

lastError.code

string

Structured error code (e.g. MH_037).

lastError.message

string

Human-readable error message.

lastError.at

string

ISO 8601 timestamp of when the error occurred.

recovery

object | null

Recovery options. Only populated when phase is recoverable, settled, rescued, or reclaimed.

Show recovery fields

recovery.canRescue

boolean

Whether locked funds can be rescued via /rescue/prepare.

recovery.rescuableLamports

integer

Total lamports recoverable.

recovery.rescuableAccounts

array

Accounts with locked funds: [{ kind, lamports }]

recovery.canReclaimRent

boolean

Whether closed step account rent can be reclaimed.

recovery.reclaimableLamports

integer

Total reclaimable rent in lamports.

signatures

object

On-chain transaction signatures recorded for this transfer.

Show signatures fields

signatures.routeInit

array

Route initialization transaction hashes.

signatures.sessionInit

array

Session initialization transaction hashes.

signatures.hops

array

Hop execution transaction hashes.

curl /api/v1/transfers/42 \
  -H "x-api-key: mh_live_abc123..."

curl /api/v1/transfers/by-external/order_12345 \
  -H "x-api-key: mh_live_abc123..."

{
  "id": 42,
  "externalId": "order_12345",
  "status": "processing",
  "phase": "executing",
  "progress": { "hopsCompleted": 3, "hopsTotal": 7 },
  "lastError": null,
  "recovery": null,
  "signatures": {
    "routeInit": ["4mGxFn7m..."],
    "sessionInit": [],
    "hops": ["9rTpWx2a...", "7kLmQv4b..."]
  }
}

{
  "error": {
    "code": "MH_030",
    "message": "Transfer not found"
  }
}

Confirm Broadcast List Transfers

API documentation

Transfers

Webhooks

Integration

Path parameters

Response

​Path parameters

​Response

Path parameters

Response