---
title: "Get Asset By External Id"
method: GET
path: "/entities/asset/external-id/{external_id}"
tags: ["4. Assets"]
---

# Get Asset By External Id

`GET /entities/asset/external-id/{external_id}`

Get a specific asset by its external ID (vendor-specific identifier).

Returns the asset details if it exists. This is useful for integrations where the external system ID is known but not the Axle UUID.

## Path parameters

- `external_id` string, required

## Response `200`

Asset details

- AssetResponse — Response model for asset information.
  - `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

## Other responses

- `404` — Asset not found or not authorized to access
- `422` — Validation Error
- `500` — Server error while retrieving asset

---

[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)