Retrieve an asset by unique asset Id

An asset, often referred to as a token, represents a digital artifact on the TEOS platform that can be stored, managed, and verified on blockchain.

This endpoint retrieves a single asset identified by its uniqueAssetId.

📘 Learn more about assets.

Request Endpoint:

GET /odata/v1.0/Assets({key})

Parameters

Name	Type	Description	Mandatory
key	string	The requested uniqueAssetId. Example: '0x86766979FD04114E1F90001'	✅

Supports OData query options: $expand, $select.

Example Request

GET /Assets('0x86766979FD04114E1F90001')?$select=Name,Author,Description

Response Body

application/json— Returns the requested asset object.

Asset Object Fields

Parameter	Description
Id	The unique asset ID.
Author	Address of the asset creator.
Name	Name of the asset.
Description	Description of the asset.
LanguageCode	Default language code (ISO 2).
JurisdictionCode	Jurisdiction country code (ISO 2).
UnitOfMeasureCode	Unit of measure of the asset.
CurrencyCode	Currency code (ISO 4217).
SparkFactor	Number of Sparks per unit.
SparkFactorModifier	Formula defining Spark factor.
AssetClassCode	Class of the asset.
CustomDefinitionItems	List of custom properties.
AssetLinkIds	List of linked asset IDs.
CreatedInBlockchainOn	Timestamp when asset was activated in blockchain.
AmendedInBlockchainOn	Timestamp of last blockchain amendment.
BlockchainHash	Blockchain hash of asset documentation.
DocumentDbHash	Hash of asset documentation in TEOS database.
TransactionId	Transaction ID where asset was written to blockchain.
ControllerAddress	Controller address for the asset.
Translations	List of asset translations by language.
State	Current state of the asset.

CustomDefinitionItems Fields

Parameter	Description
Key	Unique identifier of the custom property.
Name	Name of the custom property.
Type	Type of the custom property (e.g., TEXT).
Value	Value of the property.
SectionsPath	JSON path where property is located.
SectionsPathNames	Labels for sections in JSON path.

Translations Fields

Parameter	Description
LanguageCode	Language code of translation (ISO 2).
Name	Translated asset name.
Description	Translated asset description.
CustomDefinitionItems	Custom properties in the specific language.

Example Response Body

In EVM-compatible networks (e.g., Sparknet, Ethereum, and Polygon), the "Author" is 42 characters long. In non-EVM networks, the address length may differ. For example, on Internet Computer, the "Author" has 63 characters.

{
  "Id": "0x5db616f7e9aaa6fce9b0001",
  "Author": "0xabe9e6c2b231ae427cd089b2b68be0a1dab565a1",
  "Name": "Gold",
  "Description": "1oz Gold bars",
  "LanguageCode": "en",
  "JurisdictionCode": "CH",
  "UnitOfMeasureCode": "kg",
  "CurrencyCode": "str",
  "SparkFactor": "1000000",
  "SparkFactorModifier": "{\"type\":\"FORMULA\",\"start\":\"2021-08-12T14:01:52Z\",\"t\":\"1d\",\"f\":\"1\"}",
  "AssetClassCode": "\"A017\" - Document",
  "CustomDefinitionItems": [
    {
      "Key": "apitutorial",
      "Name": "API Tutorial",
      "Type": "TEXT",
      "Value": "My Private documentation: lorem ipsum",
      "SectionsPath": "[documentation][manuals]",
      "SectionsPathNames": "[Documentation][Manuals]"
    }
  ],
  "AssetLinkIds": ["string"],
  "CreatedInBlockchainOn": "2021-05-18T15:23:12.5246259+02:00",
  "AmendedInBlockchainOn": "2021-05-18T15:23:12.5246259+02:00",
  "BlockchainHash": "0x263865a752660b9dd6b9377df57466d1348661aa9a49d5dde8e9d16dddddf69b",
  "DocumentDbHash": "263865a752660b9dd6b9377df57466d1348661aa9a49d5dde8e9d16dddddf69b",
  "TransactionId": "C0D34D73-6FD3-40F2-A7E1-08D9412448F7",
  "ControllerAddress": "string",
  "Translations": [
    {
      "LanguageCode": "en",
      "Name": "Gold",
      "Description": "1oz Gold bars",
      "CustomDefinitionItems": [
        {
          "Key": "apitutorial",
          "Name": "API Tutorial",
          "Type": "TEXT",
          "Value": "My Private documentation: lorem ipsum",
          "SectionsPath": "[documentation][manuals]",
          "SectionsPathNames": "[Documentation][Manuals]"
        }
      ]
    }
  ],
  "State": "CreatedInTeos"
}

Response Codes

Code	Description
200	Asset successfully retrieved.
400	The request is invalid. Error details included.
401	Unauthorized.
404	The asset does not exist.