ownership-controller

getOwnershipById

Returns ownership by Id

Request
path Parameters
ownershipId
required
string (OwnershipId)

Ownership Id in format: '${blockchain}:${token}:${tokenId}:${owner}'

Example: ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8:32292934596187112148346015918544186536963932779440027682601542850818403729410:0x4765273c477c2dc484da4f1984639e943adccfeb
Responses
200

OK

400

Bad Request

404

Not Found

500

Internal Server Error

get/v0.1/ownerships/{ownershipId}
Response samples
application/json
{
  • "id": "ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8:32292934596187112148346015918544186536963932779440027682601542850818403729410:0x4765273c477c2dc484da4f1984639e943adccfeb",
  • "blockchain": "ETHEREUM",
  • "itemId": "ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8:32292934596187112148346015918544186536963932779440027682601542850818403729410",
  • "contract": "ETHEREUM:0xd07dc4262bcdbf85190c01c996b4c06a461d2430",
  • "collection": "ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8",
  • "tokenId": 123456,
  • "owner": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb",
  • "value": 123456,
  • "source": "MINT",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "lastUpdatedAt": "2019-08-24T14:15:22Z",
  • "creators": [ ],
  • "lazyValue": 123456,
  • "pending": [ ],
  • "auction": {
    },
  • "bestSellOrder": {
    },
  • "originOrders": [
    ]
}

getOwnershipsByIds

Returns Ownerships by Ids

Request
Request Body schema: application/json
ids
required
Array of strings (OwnershipId)

List of the Ownerships ids

Responses
200

OK

400

Bad Request

500

Internal Server Error

post/v0.1/ownerships/byIds
Request samples
application/json
{
  • "ids": [
    ]
}
Response samples
application/json
{
  • "total": 0,
  • "continuation": "string",
  • "ownerships": [ ]
}

getOwnershipsByItem

Returns ownerships by item

Request
query Parameters
itemId
required
string (ItemId)

Item Id, has format ${blockchain}:${token}:${tokenId}

Example: itemId=ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8:32292934596187112148346015918544186536963932779440027682601542850818403729410
continuation
string

Continuation token from the previous response

size
integer

The number of items to return

Responses
200

OK

400

Bad Request

500

Internal Server Error

get/v0.1/ownerships/byItem
Response samples
application/json
{
  • "total": 0,
  • "continuation": "string",
  • "ownerships": [ ]
}

search

Complex ownerships search

Request
Request Body schema: application/json
size
required
integer <int32> [ 1 .. 1000 ]
Default: 50

Number of entities returned

continuation
string

Continuation token to paginate ownerships search result

required
object (OwnershipSearchFilter)

Filter for ownerships search query

sort
string (OwnershipSearchSort)
Enum: "LATEST" "EARLIEST" "HIGHEST_SELL" "LOWEST_SELL"
Responses
200

OK

400

Bad Request

500

Internal Server Error

post/v0.1/ownerships/search
Request samples
application/json
{
  • "size": 50,
  • "continuation": "string",
  • "filter": {
    },
  • "sort": "LATEST"
}
Response samples
application/json
{
  • "total": 0,
  • "continuation": "string",
  • "ownerships": [ ]
}