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. An object with a `geojsonGeometry` field that holds a GeoJSON geometry of type `Point`, `LineString` or `Polygon`.	See request example	Yes
endTime	string	End time of the asset's validity period (ISO 8601). After this time the asset is no longer displayed in the platform. If omitted, the asset never expires.	"2024-03-01T00:00:00Z"	No
attributes	object	Custom metadata as key/value pairs.	See request example	No
timeZone	string	IANA time zone of the asset.	"America/New_York"	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",
      "endTime": "2026-12-31T00:00:00Z",
      "attributes": {
        "status": "active",
        "department": "Environmental Monitoring",
        "owner": "John Smith",
        "cost_center": "CC-001-ENV",
        "serial_number": "00135",
        "maintenance_schedule": "Monthly"
      }
    }
  ]
}

Response

Status	Meaning
201	Assets accepted for ingestion. The response body is empty.
400	Invalid request body (for example a missing required field, an unknown field, an unsupported geometry, or more than 200 assets).
401	Missing or invalid API key.

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. Each feed acts as a dedicated layer through which assets are ingested, displayed, and managed. If the feedId in the URL does not exist yet, it is created automatically on the first request.
Limitations: You can submit up to 200 assets per request. Each asset must have a unique id within the feed.
GeoJSON Format: The location field wraps a GeoJSON geometry in a geojsonGeometry object. Supported geometry types are Point, LineString and Polygon. Coordinates are [longitude, latitude]. A GeoJSON Feature ({"type": "Feature", "geometry": {...}, "properties": {...}}) is also accepted inside geojsonGeometry.
Attributes: Used to store custom metadata. Each attribute must include a key and a value.
Updating assets: Sending an asset with an id that already exists in the feed updates that asset instead of creating a new one.