---
title: "Get Assets"
method: GET
path: "/entities/asset"
tags: ["4. Assets"]
---

# Get Assets

`GET /entities/asset`

Get all assets with pagination.

Returns a page of assets with the total count and the requested subset of asset records. Use the limit and offset parameters to navigate through pages of results.

## Query parameters

- `limit` integer — Maximum number of assets to return (1-5000)
- `offset` integer — Number of assets to skip for pagination

## Response `200`

Page of assets with pagination info

- AssetResponsePage — Paginated response for asset listings.
  - `assets` AssetResponse[], required — List of assets for the current page
    - `id` string, uuid, required — Axle's internal UUID for the asset
    - `external_id` string, required — Vendor-specific identifier for the asset
    - `type` 'boundary meter' | 'charger' | 'battery' | 'heat pump' | 'hot water tank' | 'frequency meter' | 'electric_vehicle' | 'pv inverter', required — An enumeration.
    - `site_id` string, uuid, required — ID of the site where the asset is located
    - `properties` AssetProperties — Optional properties for an asset.
      - `power_kw` number — Power rating in kW
      - `capacity_kwh` number — Capacity in kWh
  - `total_num_assets` integer, required — Total number of assets available
  - `total_num_pages` integer, required — Total number of pages available
  - `page_number` integer, required — Current page number (1-based)

## Other responses

- `422` — Validation Error
- `500` — Server error while retrieving assets

---

[API](https://skmtc.dev/axle/apis/axle-api-docs.md) · [All operations](https://skmtc.dev/axle/apis/axle-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axle/axle-api-docs/revisions/75be7f9a952f/schema)