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

POST: 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
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
attributes	object	Custom metadata for the asset.	See request example	No

Request Example

{
  "data": [
    {
      "id": "custom_sensor_001",
      "name": "Custom Weather Station",
      "location": {
        "geojsonGeometry": {
          "type": "Point",
          "coordinates": [-73.935242, 40.73061]
        }
      },
      "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. 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 100 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.
Attributes: Used to store custom metadata. Each attribute must include a key and a value.