Institution Assets API

The Institution Assets API allows you to retrieve a paginated list of all assets uploaded under your institution profile.

This endpoint is particularly useful for retrieving assets' unique UUIDs (id), which can then be passed as the asset_id parameter to location-level APIs.

Endpoint

GET https://app.alphageo.ai/api/public/v1/assets

Parameters

Parameters	Required	Type	Description
page		Integer	The page number to retrieve.
page_size		Integer	Number of assets to return per page. Allowed choices: 10, 25, 50, 100, 200. Default: 25.

Example requests

cURL

$ curl --location 'https://app.alphageo.ai/api/public/v1/assets/?page=1&page_size=25' \
--header 'Authorization: dse3X8de878c37b2fd6835c52390303fk15fc3'

Python

import requests

url = "https://app.alphageo.ai/api/public/v1/assets/?page=1&page_size=25"

payload = {}
headers = {
  'Authorization': 'dse3X8de878c37b2fd6835c52390303fk15fc3'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Example response

{
  "count": 15,
  "next": "https://docs.alphageo.ai/api/public/v1/assets/?page=2&page_size=25",
  "previous": null,
  "results": [
    {
      "id": "e0axc2a7-0355-412d-bdx4-dssxd4ex419a",
      "asset_name": "NY Office",
      "address": "420 5th Ave.",
      "longitude": 1-73.985381,
      "latitude": 40.751835,
      "portfolio_name": "Sample Portfolio",
      "tier_2_name": "North America",
      "tier_3_name": "",
      "tier_4_name": "",
      "city": "New York",
      "state": "New York",
      "zip_code": "10018",
      "country": "USA",
      "asset_type": "Office",
      "valuation": null,
      "year_valuation": null,
      "tags": []
    }
  ]
}