---
search:
  tags:
    - Assets
    - GET
seo:
  description: >-
    One asset by its id, in the same shape as an item of the listing: its
    product identity, install… Reference for the GET /assets/{id} endpoint in
    the Sibi API.
sidebar:
  label: Get asset
  badge: GET
title: Get asset
type: openapi-operation
---
One asset by its id, in the same shape as an item of the listing: its product identity, install address, dimensions, and warranty coverage windows. The id is accepted as this API serves it (`as_`-prefixed) or without the prefix. Responds 404 when no asset with that id exists, or when the caller is not authorized to view it.

`GET /assets/{id}`

**Responses**

- `200` — The asset
- `400` — Invalid input parameters (VALIDATION\_ERROR)
- `401` — The Authorization header is missing, or the bearer token could not be resolved (invalid, expired, or revoked)
- `403` — The token is missing the scope this operation requires (INSUFFICIENT\_SCOPE), is a GraphQL token rather than a REST API token (REST\_TOKEN\_REQUIRED), or it was minted for the other environment (TOKEN\_ENVIRONMENT\_MISMATCH)
- `404` — No asset with this id exists, or the caller is not authorized to view it — the two are deliberately indistinguishable
- `500` — Internal server error
- `503` — The token-exchange service is unavailable or misconfigured — retry shortly. Not a token problem.

Response example, 200:

```json
{
  "id": "as_aBcD1234",
  "createdAt": "string",
  "manufacturer": "string",
  "viewUrl": "string",
  "name": "string",
  "sku": "string",
  "serialNumber": "string",
  "externalId": "hvac-unit-7",
  "externalMetadata": {
    "costCenter": "CC-114"
  },
  "installedAt": "2020-06-15T14:30:00.000Z",
  "category": "string",
  "subcategories": [
    "string"
  ],
  "returned": true,
  "poNumber": "string",
  "orderId": "string",
  "propertyAddress": {
    "line1": "string",
    "line2": "string",
    "city": "string",
    "stateOrProvince": "string",
    "postalCode": "string"
  },
  "property": {
    "externalId": "string"
  },
  "dimensions": {
    "height": 0,
    "heightUnit": "string",
    "width": 0,
    "widthUnit": "string",
    "depth": 0,
    "depthUnit": "string",
    "length": 0,
    "lengthUnit": "string"
  },
  "warrantyCoverages": [
    {
      "startDate": "string",
      "endDate": "string",
      "description": "One-year GE manufacturer warranty covering parts and labor for defects in materials or workmanship."
    }
  ]
}
```