# Asset

An asset is a one-time purchase item or a perpetual license within the Marketplace Platform. Assets assist vendors and SoftwareOne in differentiating each one-time item in the agreement.

The Asset object stores the fulfillment parameters provided by the vendor for these one-time items. This enables vendors to effectively identify and manage their one-time items by utilising the parameters stored during the fulfillment phase.

This object contains the following attributes:

<table><thead><tr><th width="129">Field Name</th><th width="146">Data Type</th><th>Example</th></tr></thead><tbody><tr><td><code>id</code></td><td>string</td><td><p>The ID of the asset.</p><p>Example: AST-2876-9782-1823</p></td></tr><tr><td><code>name</code></td><td>string</td><td><p>The name of the asset.</p><p>Example: Access LTSC 2024 for Stark</p></td></tr><tr><td><code>status</code></td><td>string</td><td><p>The status of the asset. </p><p>Example: Active</p></td></tr><tr><td><code>lines</code></td><td>object (<a href="line">line</a>)</td><td><pre class="language-json" data-line-numbers><code class="lang-json">[
   {
      "id": "ALI-1234-1234-1234-0001",
      "item": {
        "id": "ITM-1234-1234-1234-0021",
        "name": "Adobe Illustrator"
      },
      "quantity": 10,
      "price": { ... },
      "subscription": { "id": "SUB-1234-1234-1234" }
    },
    {
      "id": "ALI-1234-1234-1234-0002",
      "item": {
        "id": "ITM-4444-4444-4444-0031",
        "name": "Adobe Photoshop"
      },
      "quantity": 1,
      "price": { ... }
    }
]
</code></pre></td></tr><tr><td><code>price</code></td><td>(object) <a href="../common-api-objects/price">price</a></td><td><pre class="language-json" data-line-numbers><code class="lang-json">{  
  "PPx1": 150,
  "SPx1": 165,
  "markup": 0.10,  
  "margin": 0.11,
  "defaultMarkup": 5.0,
  "currency": "USD"
}
</code></pre></td></tr><tr><td><code>externalIDs</code></td><td>(object) <a href="../common-api-objects/externalids">externalIDs</a></td><td><pre class="language-json" data-line-numbers><code class="lang-json">{
  "client": "12345678",
  "vendor": "ABC-2023-C07-dbeee0b302c0"
}
</code></pre></td></tr><tr><td><code>template</code></td><td>(object) <a href="../catalog-api/templates">template</a></td><td><pre class="language-json" data-line-numbers><code class="lang-json">{
<strong>  "id": "TPL-2434-7545",    
</strong><strong>  "name": "Successful Deployment"
</strong>}
</code></pre></td></tr><tr><td><code>parameters.fulfillment</code></td><td>(object) <a href="../common-api-objects/order-parameter">orderParameter</a></td><td><pre class="language-json" data-line-numbers><code class="lang-json">{
    "name": "Order ID",
    "value": "ORD-2378-8237-9182",
    "constraints": {
        "readonly": false,
        "hidden": false,
        "required": true,
        "unique": false
    }
}
</code></pre></td></tr><tr><td><code>audit</code></td><td>(object) <a href="../common-api-objects/audit">audit</a></td><td><p></p><pre class="language-json" data-line-numbers><code class="lang-json">{
  "created": { "at": "...", "by": { } },
  "updated": { "at": "...", "by": { } },
  "terminated": { "at": "...", "by": { } }
}
</code></pre></td></tr><tr><td><code>agreement</code></td><td>(object) <a href="agreements">agreement</a></td><td><pre class="language-json" data-line-numbers><code class="lang-json">{
  "id": "AGR-2634-1298-0221",
  "name": "Microsoft Agr for Stark Industries"
}
</code></pre></td></tr><tr><td><code>product</code></td><td>(object) <a href="../catalog-api/product">product</a></td><td><pre class="language-json" data-line-numbers><code class="lang-json">{
  "id": "PRD-7562-8393-0192",
  "name": "Microsoft Perpetual"
}
</code></pre></td></tr><tr><td><code>licensee</code></td><td>(object) <a href="../accounts-api/licensee">licensee</a></td><td><pre class="language-json" data-line-numbers><code class="lang-json">{
  "id": "LCE-7562-8393-0192",
  "name": "Stark Industries"
}
</code></pre></td></tr><tr><td><code>listing</code></td><td>(object) <a href="../catalog-api/listing">listing</a></td><td><pre class="language-json" data-line-numbers><code class="lang-json">{
  "id": "LST-1234-1234"
}
</code></pre></td></tr><tr><td><code>priceList</code></td><td>(object) <a href="../catalog-api/pricelists">priceList</a></td><td><pre class="language-json" data-line-numbers><code class="lang-json">{
  "id": "PRC-1234-5678-9012"
}
</code></pre></td></tr></tbody></table>

## Example response

{% code lineNumbers="true" %}

```json
{
  "id": "AST-2876-9782-1823", 
  "name": "Access LTSC 2024 for Stark",
  "status": "Active",
  "lines": [
   {
      "id": "ALI-1234-1234-1234-0001",
      "item": {
        "id": "ITM-1234-1234-1234-0021",
        "name": "Adobe Illustrator"
      },
      "quantity": 10,
      "price": { ... },
      "subscription": { "id": "SUB-1234-1234-1234" }
    },
    {
      "id": "ALI-1234-1234-1234-0002",
      "item": {
        "id": "ITM-4444-4444-4444-0031",
        "name": "Adobe Photoshop"
      },
      "quantity": 1,
      "price": { ... }
    }
  ],
  "price": {  
    "PPx1": 150,
    "SPx1": 165,
    "markup": 0.10,  
    "margin": 0.11,
    "defaultMarkup": 5.0,
    "currency": "USD"
  },
  "externalIDs": {
    "client": "12345678",
    "vendor": "ABC-2023-C07-dbeee0b302c0"
  },
  "template": {
      "id": "TPL-2434-7545",    
      "name": "Successful Deployment"
  },
  "parameters": {
    "fulfillment": {
        "name": "Order ID",
        "value": "ORD-2378-8237-9182",
        "constraints": {
            "readonly": false,
            "hidden": false,
            "required": true,
            "unique": false
        }
    }
  },
  "agreement": {
    "id": "AGR-2634-1298-0221",
    "name": "Microsoft Agr for Stark Industries"
  },
  "product": {
    "id": "PRD-7562-8393-0192",
    "name": "Microsoft Perpetual"
  },
  "licensee": {
    "id": "LCE-7562-8393-0192",
    "name": "Stark Industries"
  },
  "listing": {
    "id": "LST-1234-1234"
  },
  "priceList": {
    "id": "PRC-1234-5678-9012"
  },
  "audit": {
    "created": { "at": "...", "by": { } },
    "updated": { "at": "...", "by": { } }
  }
}
```

{% endcode %}