---
search:
  tags:
    - Assets
    - GET
seo:
  description: >-
    A page of the assets the caller can see, each carrying its product identity,
    install address,… Reference for the GET /assets endpoint in the Sibi API.
sidebar:
  label: List assets
  badge: GET
title: List assets
type: openapi-operation
---
A page of the assets the caller can see, each carrying its product identity, install address, dimensions, and warranty coverage windows. With no `address` this lists every asset the caller can see, oldest first by creation time; it is meant for exports, not realtime use. Supply `address` to narrow to the assets installed at one property. Page by passing the previous response’s `next` back as `after` until `next` is null. A page can come back shorter than `first` and still carry a cursor.

`GET /assets`

**Responses**

- `200` — Assets the caller is authorized to view
- `400` — Invalid input parameters (VALIDATION\_ERROR), or \`after\` is not a cursor this endpoint issued (INVALID\_CURSOR)
- `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)
- `500` — Internal server error
- `503` — The token-exchange service is unavailable or misconfigured — retry shortly. Not a token problem.

Response example, 200:

```json
{
  "items": [
    {
      "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."
        }
      ]
    }
  ],
  "next": "string"
}
```