---
title: "Gets a list of connectors"
method: GET
path: "/c2c/v4/connectors"
tags: ["C2C"]
---

# Gets a list of connectors

`GET /c2c/v4/connectors`

Gets a list of cloud-to-cloud connectors for the project `projectId`.

## Query parameters

- `pageToken` string
- `limit` integer

## Response `200`

Successful

- object
  - `count` integer, required — Number of items returned in the response
  - `items` object[], required
    - `connectorId` string — Identifier of the connector.
    - `projectId` string — 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.
    - `description` string — Brief description of the connector.
    - `driverId` string, required — Identifier of the driver to be used with this connector.
    - `enabled` boolean, required — Enabled state of the connector. If set to false then the connector will not execute periodically.
    - `externalCloudInfo` object, 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.
    - `name` string, required — Name of the connector.
    - `refreshIntervalS` integer — 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.
    - `lastExecTs` string — Timestamp of the last connection execution.
    - `totalAddedDevices` integer, required — Number of external devices added to the connector.
    - `createdAt` string, date-time, required — Timestamp of the connector creation.
  - `limit` integer, required — Maximum number of items as specified in request
  - `nextPageToken` string — Token to fetch the next page (if exists)

## Other responses

- `400` — Bad request The request object is in an incorrect format or has values that are invalid or out of range. If available, further error details are provided in the response body.
- `401` — Unauthorized The request did not provide correct authentication details
- `403` — Forbidden The account does not have the correct privileges

---

[API](https://skmtc.net/here/apis/tracking.md) · [All operations](https://skmtc.net/here/apis/tracking/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/here/tracking/revisions/efa162f7023c/schema)