Sign in

v1

latestOpenAPI 3.0.0HERE Documentation License2026-07-142162791.8 MB
C2C

Gets a connector info

Gets connector info for the connector connectorId.

get/c2c/v4/connectors/{connectorId}

Path parameters

connectorIdstring required

Identifier of the connector

Response

Successful

connectorIdstring

Identifier of the connector.

projectIdstring

Project ID. Any HERE Tracking user must be a member of a Tracking project. The project ID can be implicitly resolved if the user calling the API is a member of a single project. If the user is a member of multiple projects, the projectId query parameter needs to be specified explicitly.

descriptionstring

Brief description of the connector.

driverIdstring required

Identifier of the driver to be used with this connector.

enabledboolean required

Enabled state of the connector. If set to false then the connector will not execute periodically.

externalCloudInfoobject required

An external cloud-specific object that the driver will use to login to the external cloud. The structure of this object varies per driver implementation. It is recommended to have dedicated credentials for logging in to the external cloud in order not to violate possible concurrent users policies of the external cloud. In case of the HERE Tracking loopback driver, the maximum allowed concurrent user account tokens is 3 per account, therefore it is recommended to create a separate HERE account and grant it the required privilege to update the connector's project, and use that account in externalCloudInfo.

namestring required

Name of the connector.

refreshIntervalSinteger

This is the interval (in seconds) to execute the sync process between the connector's external cloud and HERE Tracking project. The maximum and at the same time default value for callback-type connectors is 900 seconds. The default value for other type of connectors is 3600 seconds and there is no maximum value set.

lastExecTsstring

Timestamp of the last connection execution.

totalAddedDevicesinteger required

Number of external devices added to the connector.

createdAtstring date-time required

Timestamp of the connector creation.

Example response

{
  "driverId": "my-driver-1-id",
  "enabled": true,
  "externalCloudInfo": {
    "extAppId": "ext-app-id",
    "extUserId": "ext-user-id",
    "extUserPassword": "ext-user-password"
  },
  "name": "driver-name",
  "refreshIntervalS": 3600
}