Startrail APIs
  • 🛫Startrail PORT: All in one document for API/SDK
    • 🔀URL per environment
  • Issue transfer api
    • 📬Issue & Transfer SRR (NFT)
      • Request Signed URL for Upload/Download Files
      • File Information Metadata
      • Issue & Transfer
      • Webhook Setup
    • 📂Collection
      • Create Collection
      • Get Collection of LUW
    • 📢Change Logs
      • v1.2.0
      • v1.1.0
      • v1.0.1
  • Metadata Schema
    • 🪅Startrail Registry (SRR)
      • Version 2.2
      • Version 2.1
      • Version 2.0
    • 📤Transfer
      • Version 1.2
      • Version 1.1
      • Version 1.0
    • ☸️Custom History
      • Custom History of Exhibition
        • Version 1.2
      • Custom History of Auction
        • Version 1.3
      • Custom History of Appraisal
        • Version 1.1
      • Custom History of Restoration
        • Version 1.0
      • Custom History of Offchain
        • Version 1.1
  • Get SRR API
    • Get Owned SRRs
    • Get SRR by Collection contract address and Token Id
      • 🚫Get SRR by Token Id
    • Description Of SRR Data
  • Ethereum Signature Validator API
    • 🔏Ethereum Signature Validator API
      • Change Logs
  • Startrail SDK Js
    • 🔰Introduction
    • 🏃Getting Started
      • RPC endpoint and chainId
    • 💳Wallet Methods
    • 🔮Startrail API Methods
      • Add Custom Histories To SRRs
      • Approve SRR By Commitment
      • Bulk
      • Check ERC2981 Royalty
      • Create Collection
      • Convert Metadata
      • Create SRR
      • Transfer Collection Ownership
      • Transfer SRR To Ethereum Address
      • Transfer From With Provenance
      • Update Metadata
    • 📱Login Providers
      • Interface
      • Whitelabeling/Customizing
        • Email Password
      • Hints
      • Multi Factor Account Management
    • 🦊MetaMask
    • 🎎Authentication Integration
    • 👾Errors
    • 📢Change logs
      • v1.35.0
      • v1.34.0
      • v1.33.2
      • v1.33.1
      • v1.32.0
      • v1.31.1
      • v1.30.6
      • v1.30.5
      • v1.30.4
      • v1.30.3
      • v1.30.2
      • v1.30.1
      • v1.30.0
      • v1.29.1
      • v1.29.0
      • v1.28.2
      • v1.28.1
      • v1.28.0
      • v1.27.1
      • v1.27.0
      • v1.26.0
      • v1.25.2(Security Patch)
  • Startrail API
    • 💱Transfer SRR Ownership By RevealHash
    • Get Transaction Data
    • Get Metadata By tokenid
  • Subgraph
    • 📊A introduction of subgraph
    • How to retrieve SRR metadata
Powered by GitBook

©2023 Startbahn, Inc.

On this page
  • Swagger Endpoint (Test Environment)
  • Required Permissions

Was this helpful?

  1. Get SRR API
  2. Get SRR by Collection contract address and Token Id

Get SRR by Token Id

[deprecated] to get SRR data for tokens in Startrail Registry only. This endpoint is deprecated in favor of its parent record.

PreviousGet SRR by Collection contract address and Token IdNextDescription Of SRR Data

Last updated 1 year ago

Was this helpful?

GET <base_url>/port/api/v1/srr/{tokenId}

Please replace <base_url> as explained .

This endpoint is deprecated and can be removed anytime in future. is a more explicit version that covers the use case of this endpoint.

Path Parameters

Name
Type
Description

tokenId*

string

TokenId of SRR. Example: 59531933

Single object of SRR Data.

{
  "tokenId": "6460655",
  "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",
  "srOwnable": {
    "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"
    }
  ]
}

Swagger Endpoint (Test Environment)

.

Required Permissions

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

🚫
here
get SRR by Collection contract address and Token Id
Description of SRR Data.
Swagger to test