Overview

Integrate your asset information into our platform to visualize and track physical assets such as sensors, vehicles, equipment, and infrastructure. This integration enables comprehensive asset management and monitoring capabilities with real-time location tracking and attribute management.

Endpoint

https://api.tomorrow.io/v4/connect/assets/\{feedId}

Request Body Parameters

Field Name	Data Type	Description	Sample Value	Required
data	array	Array of asset items		Yes

Request Asset Data Parameters

Field Name	Data Type	Description	Sample Value	Required
id	string	Unique identifier of the asset	"asset_123456"	Yes
name	string	Display name of the asset that is visible in the platform	"Weather Sensor A"	Yes
location	object	Asset location (GeoJSON format).	See request example	Yes
timeZone	string	Time zone identifier. Defaults to "UTC"	"UTC"	No
endTime	string	End time of the asset's validity period. When expired the asset won't be displayed in the platform.	"2024-03-01T00:00:00Z"	No
typedAttributes	object	Custom attributes for the asset with typed values (e.g., color, text, number)	See request example	No

Request Example

{
  "data": [
    {
      "id": "custom_sensor_001",
      "name": "Custom Weather Station",
      "location": {
        "geojsonGeometry": {
          "type": "Point",
          "coordinates": [-73.935242, 40.73061]
        }
      },
      "timeZone": "America/New_York",
      "typedAttributes": {
         "status": {
           "value": "active",
           "type": "text"
         },
         "department": {
           "value": "Environmental Monitoring",
           "type": "text"
         },
         "owner": {
           "value": "John Smith",
           "type": "text"
         },
         "cost_center": {
           "value": "CC-001-ENV",
           "type": "text"
         },
         "serial_number": {
           "value": "00135",
           "type": "number"
         },
         "maintenance_schedule": {
           "value": "Monthly",
           "type": "text"
         }
       }
    }
  ]
}

Integration Details

Authentication: You must include a valid API key in the request headers. Contact your account manager to obtain credentials and integration access.
Feed ID: A feed is used to organize and manage groups of related assets within the Tomorrow.io platform. Before uploading any asset data via the API, a feed must be created in your account. Each feed acts as a dedicated layer through which assets are ingested, displayed, and managed.
Limitations: You can submit up to 50 assets per request. Each asset must have a unique id within the feed.
GeoJSON Format: The location field uses the standard GeoJSON Feature format with type, geometry, and optionally properties.
Typed Attributes: Used to store custom metadata. Each attribute must include a value and a type (e.g., text, number, color, datetime).