Get Owned SRRs

to get SRRs information by owner's address

GET <base_url>/port/api/v1/ownerAddress/{ownerAddress}/ownedSrrs

Please replace <base_url> as explained here.

Get issued SRR(s) that are currently owned by the given address. SRR(s) are paginated. Check the default pagination query parameters.

Path Parameters

Name	Type	Description
ownerAddress*	string	owner address. Example : 0xdf2c421c4Bc5a5694D1AE4b400886E148b378630

Query Parameters

Name	Type	Description
limit	number	Default value : 100
offset	number	Default value : 0
page	number	Default value : 1

200: OK

Description of SRR Data

Array of of SRR Data.

Description Of SRR Data.

Example

[
  {
	  "status": "issued",
	  "isPrimaryIssuer": true,
	  "issuedAt": "2021-05-17T05:31:51.000Z",
	  "createdAt": "2020-10-23T08:41:59.949Z",
	  "updatedAt": "2021-05-17T05:32:16.000Z",
	  "srrOwnable": {
	    "ownerAddress": "0x2B8A689885278012a7681C3A37aC33B9357eFA2F",
	    "createdAt": "2021-01-27T02:36:00.457Z",
	    "updatedAt": "2021-01-27T02:36:00.457Z"
	  },
	  "artist": {
	    "contractAddress": "0xd80228C535e52470C2034491cFE9dF1F840caFB9",
	    "originalName": "Willem de Kooning",
	    "englishName": "William de Kooning",
	    "userType": "artist",
	    "createdAt": "2020-10-23T07:54:54.486Z",
	    "updatedAt": "2020-10-23T07:54:54.486Z"
	  },
	  "metadata": {
	    "digest": "7dd366baa375c83d8a379bb4af12fef77f04c2b6ec46e3dbcbf1902f9145263d",
	    "json": {
	      // Check Response Data Description section below for Artwork Metadata
	    },
	    "customHistories": [
	    {
	      "id": 9,
	      "digest": "11a023bffc0145c6d3fce17ca249eb3715bf2a931f73d769e975d90f4ecd15a9",
	      "json": {
	        "city": "Tokyo",
	        "venue": {
	          "en": "Online",
	          "ja": "オンライン",
	          "zh": "一个标题"
	        },
	        "period": {
	          "to": "2020-03-21",
	          "from": "2020-01-23"
	        },
	        "$schema": "https://api.startrail.io/api/v1/customHistories/metadata/custom-history-of-auction-metadata.schema.json",
	        "hostLUW": "0x8DFea3525EE810A7FEa886Fee69c57e68B5d5052",
	        "saleName": {
          "en": "AuctionM_201207",
          "ja": "オークション ABC"
        },
	        "historyType": "auction",
	        "hostCountry": "JP"
	      },
	      "historyType": "auction",
	      "name": "AuctionM_201207",
				"collectionContractAddress": "0x5B8A689885278012a7681C3A37aC33B9357eFA2F",
	      "collection": {
	      "contractAddress": "0x5B8A689885278012a7681C3A37aC33B9357eFA2F",
	        "name": "collection name",
	        "symbol": "collection-symbol"
	      },
	      "createdAt": "2020-12-07T06:56:05.859Z",
	      "updatedAt": "2020-12-07T06:56:05.859Z"
	    }
	  ]
	},
  {
    "tokenId": "43070548",
    "status": "issued",
    "isPrimaryIssuer": true,
    "issuedAt": "2021-06-01T03:57:50.000Z",
    "createdAt": "2020-10-23T08:42:00.587Z",
    "updatedAt": "2021-06-01T04:01:14.000Z",
    "srrOwnable": {
      "ownerAddress": "0x2B8A689885278012a7681C3A37aC33B9357eFA2F",
      "createdAt": "2021-01-27T02:36:00.457Z",
      "updatedAt": "2021-01-27T02:36:00.457Z"
    },
    "artist": {
      "contractAddress": "0xd80228C535e52470C2034491cFE9dF1F840caFB9",
      "originalName": "Willem de Kooning",
      "englishName": "William de Kooning",
      "userType": "artist",
      "createdAt": "2020-10-23T07:54:54.486Z",
      "updatedAt": "2020-10-23T07:54:54.486Z"
    },
    "collectionContractAddress": "0x5B8A689885278012a7681C3A37aC33B9357eFA2F",
	      "collection": {
	        "contractAddress": "0x5B8A689885278012a7681C3A37aC33B9357eFA2F",
	        "name": "collection name",
	        "symbol": "collection-symbol"
	  },
    "metadata": {
      "digest": "f3837465d9e7f65dcc6dde2730ea06c90590209866887392e861c4842e568257",
      "json": {
	      // Check Response Data Description section below for Artwork Metadata
	    }
    "customHistories": []
  }
}

Swagger Endpoint (Test Environment)

Swagger to test.

Required Permissions

No required permission. This endpoint is public as the information is also public.