Get an asset

Get a single asset/site

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Retrieve a single asset (site) by its ID.

Endpoint

GET /2.0/assets/:id

Path Parameters

ParameterTypeRequiredDescription
idstringYesThe asset's unique identifier (ObjectId)

Response

Returns a single asset object with all available fields. See the Asset object reference for the full list of fields.

{
  "_id": "507f1f77bcf86cd799439011",
  "siteName": "Headquarters",
  "siteCode": "HQ-001",
  "address": {
    "streetAddress": "123 Main Street",
    "locality": "London",
    "region": "Greater London",
    "postCode": "EC1A 1BB",
    "countryCode": "gb",
    "latitude": "51.5074",
    "longitude": "-0.1278"
  },
  "assetType": "Office",
  "floorArea": 5000,
  "floorAreaUnit": "metric",
  "noOfFloors": 3,
  "gav": "15000000",
  "gavCurrency": "gbp",
  "occupationStatus": "occupied",
  "vacancyRate": 0,
  "constructionYear": 2010,
  "ownedSince": "2020-03-15T00:00:00.000Z",
  "tenure": "leasehold",
  "tenantControlledPercent": 60,
  "landlordControlledPercent": 40,
  "occupancyLevel": 95,
  "status": "active",
  "tags": ["london", "office"],
  "createdAt": "2024-01-15T09:30:00.000Z",
  "updatedAt": "2024-06-20T14:15:00.000Z"
}

Example Request

curl -X GET "https://api.etainabl.com/2.0/assets/507f1f77bcf86cd799439011" \
  -H "x-api-key: YOUR_API_KEY"

Scope Required

read:assets

Path Params
string
required

Asset ID

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json