Skip to main content

Read Snapshot

GET /snapshots/:snapshot_id​

Get the snapshot of a user by id.

info

When reading the transfer details, if it is not the transfer record of the current user, 403 will be returned, and 404 will be returned if the record is not found.

Endpoint URL

 https://api.mixin.one/snapshots/:snapshot_id

Authentication and options

Authorization
SNAPSHOTS:READ
LimitationNo limitation

Parameters

snapshot_id
*required
the snapshot's id which you are getting

Example request

curl -i -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" https://api.mixin.one/snapshots/8f5b244e-cf86-4374-8eaa-c551fd70cd83
Response
{
  "data": {
    "amount":     "-1688168",
    "asset": {
      "asset_id": "965e5c6e-434c-3fa9-b780-c50f43cd955c",
      "chain_id": "43d61dcd-e413-450d-80b8-101d5e903357",
      "icon_url": "https://images.mixin.one/0sQY63dDMkWTURkJVjowWY6Le4ICjAFuu3ANVyZA4uI3UdkbuOT5fjJUT82ArNYmZvVcxDXyNjxoOv0TAYbQTNKS=s128",
      "name":     "Chui Niu Bi",
      "symbol":   "CNB",
      "type":     "asset"
    },
    "created_at": "2018-05-29T09:31:04.202186212Z",
    "data":       "",
    "snapshot_id":"529934b0-abfd-43ab-9431-1805773000a4",
    "source":     "TRANSFER_INITIALIZED",
    "type":       "snapshot",
    "state": "fuel:signed",
    "snapshot_hash": "ba2ebc18cdc3a004dc446aad6f31d8328e9c4ff36b1dbb063dbe27d38d798b1c",
    // Options only for user (or App) who has access.
    // 4 private fields that only be returend with correct permission
    "user_id":    "06aed1e3-bd77-4a59-991a-5bb5ae6fbb09",
    "trace_id":   "7c67e8e8-b142-488b-80a3-61d4d29c90bf",
    "opponent_id":"a465ffdb-4441-4cb9-8b45-00cf79dfbc46",
    "data":       "Transfer!"
  }
}

GET /snapshots/trace/:id​

This API is only for reading transfers, not deposits or withdrawals.

Example request

curl -i -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" https://api.mixin.one/transfers/trace/7c67e8e8-b142-488b-80a3-61d4d29c90bf