# 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 -[ link](https://app.gitbook.com/o/ZaeNizhnU47lCcTSk7wB/s/8Gkk33l0DIIchfRT86LP/~/changes/1/resources/using-the-teos-api/concepts/asset)

#### Request Endpoint:

```http
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**

```http
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.

```json
{
  "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.                       |

<br>