Cognite · Schema

TimeSeries

A time series in Cognite Data Fusion represents a sequence of data points in time order, either numeric or string values.

Industrial IoTManufacturingIndustrial DataDigital TwinAsset ManagementTime SeriesIndustrial AI

Properties

Name Type Description
id integer A server-generated ID for the object.
externalId string The externally supplied ID for the time series.
instanceId object Reference to a Data Modeling instance.
name string The display short name of the time series.
isString boolean True if the time series contains string values; false if it contains numeric values.
type string The data type of the data points.
metadata object Custom, application specific metadata. String key -> String value.
unit string The physical unit of the time series (free-text field).
unitExternalId string The physical unit of the time series as represented in the unit catalog.
assetId integer Asset ID of equipment linked to this time series.
isStep boolean Defines whether the time series is a step series or not.
description string Description of the time series.
securityCategories array The required security categories to access this time series.
dataSetId integer The ID of the dataset this time series belongs to.
createdTime integer The number of milliseconds since epoch (Unix timestamp).
lastUpdatedTime integer The number of milliseconds since epoch (Unix timestamp).
View JSON Schema on GitHub

JSON Schema

cognite-timeseries-schema.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://api-docs.cognite.com/schemas/timeseries",
  "title": "TimeSeries",
  "description": "A time series in Cognite Data Fusion represents a sequence of data points in time order, either numeric or string values.",
  "type": "object",
  "required": ["id", "isString", "isStep", "type", "createdTime", "lastUpdatedTime"],
  "properties": {
    "id": {
      "type": "integer",
      "format": "int64",
      "description": "A server-generated ID for the object."
    },
    "externalId": {
      "type": "string",
      "maxLength": 255,
      "description": "The externally supplied ID for the time series."
    },
    "instanceId": {
      "type": "object",
      "description": "Reference to a Data Modeling instance.",
      "required": ["space", "externalId"],
      "properties": {
        "space": {"type": "string"},
        "externalId": {"type": "string"}
      }
    },
    "name": {
      "type": "string",
      "maxLength": 255,
      "description": "The display short name of the time series."
    },
    "isString": {
      "type": "boolean",
      "description": "True if the time series contains string values; false if it contains numeric values."
    },
    "type": {
      "type": "string",
      "enum": ["numeric", "string"],
      "description": "The data type of the data points."
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Custom, application specific metadata. String key -> String value."
    },
    "unit": {
      "type": "string",
      "maxLength": 32,
      "description": "The physical unit of the time series (free-text field)."
    },
    "unitExternalId": {
      "type": "string",
      "maxLength": 64,
      "description": "The physical unit of the time series as represented in the unit catalog."
    },
    "assetId": {
      "type": "integer",
      "format": "int64",
      "description": "Asset ID of equipment linked to this time series."
    },
    "isStep": {
      "type": "boolean",
      "description": "Defines whether the time series is a step series or not."
    },
    "description": {
      "type": "string",
      "maxLength": 1000,
      "description": "Description of the time series."
    },
    "securityCategories": {
      "type": "array",
      "items": {
        "type": "integer",
        "format": "int64"
      },
      "description": "The required security categories to access this time series."
    },
    "dataSetId": {
      "type": "integer",
      "format": "int64",
      "description": "The ID of the dataset this time series belongs to."
    },
    "createdTime": {
      "type": "integer",
      "format": "int64",
      "description": "The number of milliseconds since epoch (Unix timestamp)."
    },
    "lastUpdatedTime": {
      "type": "integer",
      "format": "int64",
      "description": "The number of milliseconds since epoch (Unix timestamp)."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/cognite-timeseries"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.