Transfer History

Retrieve list of ownership transfers by tag

get

Retrieves a list of ownership transfer records for the specified tag UID.

• The type query parameter is required to determine the kind of transfer (mint, claim, or recover).

• For mint and claim, the receiver parameter must be provided. sender must not be present.

• For recover, the sender parameter must be provided. receiver must not be present.

Requests that provide unexpected or missing parameters will return a 406 error.

Path parameters

uidstringRequired

Unique ID of the tag

Example: ABC123TAGUID

Query parameters

typestringOptional

Type of transfer (mint, claim or recover)

senderstringOptional

Sender wallet address

receiverstringOptional

Receiver wallet address

Responses

200

A list of tag transfers

application/json

404

Tag not found (invalid UID)

application/json

406

Invalid or unexpected parameters

application/json

get

HTTPcURLJavaScriptPython

GET /external/v1/transfers/{uid} HTTP/1.1
Host: 
Accept: */*

{
  "transfers": [
    {
      "id": 108,
      "tag_uid": "042C306A2817260",
      "nft_token_id": 2,
      "sender_address": null,
      "receiver_address": "0x803d7be89C5880bEA2F13bc62718a4846f801CFD",
      "transfer_type": "transfer",
      "created_at": "2011-05-28T20:52:34.154Z",
      "sender_email": null,
      "receiver_email": "l*****@d********.c**"
    },
    {
      "id": 107,
      "tag_uid": "042C306A2817260",
      "nft_token_id": 2,
      "sender_address": null,
      "receiver_address": null,
      "transfer_type": "claim",
      "created_at": "2024-05-28T19:49:49.574Z",
      "sender_email": null,
      "receiver_email": null
    }
  ]
}