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

integer

required

The internal transfer ID.

Response

integer

Transfer ID.

string

string

object

Show progress fields

integer

Number of hops that have executed.

integer

Total number of hops in the route.

object | null

Last error recorded for this transfer, if any.

Show lastError fields

string

Structured error code (e.g. MH_037).

string

Human-readable error message.

string

ISO 8601 timestamp of when the error occurred.

object | null

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

Show recovery fields

boolean

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

integer

Total lamports recoverable.

array

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

boolean

Whether closed step account rent can be reclaimed.

integer

Total reclaimable rent in lamports.

object

On-chain transaction signatures recorded for this transfer.

Show signatures fields

array

Route initialization transaction hashes.

array

Session initialization transaction hashes.

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"
  }
}

API documentation

Transfers

Webhooks

Integration

Path parameters

Response

​Path parameters

​Response

Path parameters

Response