---
title: "List trackings"
method: GET
path: "/content-tracking/v1/trackings"
tags: ["Content Tracking"]
---

# List trackings

`GET /content-tracking/v1/trackings`

## Request

- Base URL: `https://api.influencity.com`
- URL: `https://api.influencity.com/content-tracking/v1/trackings`
- Auth: HTTP bearer

Returns paginated content trackings for the authenticated brand. Example: `curl "$BASE/v1/trackings?page=1&limit=20&sortBy=startDate&sortOrder=desc" -H "Authorization: Bearer $TOKEN"`.

## Query parameters

- `page` integer: 1-based page number.
- `limit` integer: Page size (max 100).
- `sortBy` 'name' | 'startDate' | 'endDate' | 'status' | 'type' | 'createdAt' | '_id': Field to sort by.
- `sortOrder` 'asc' | 'desc': Sort direction.

## Response `200`

Paginated trackings for the authenticated brand.

- ContentTrackingListTrackingsResponse
  - `data` ContentTrackingTrackingListItem[], required: Trackings for the current page.
    - `trackingId` string, required: Tracking identifier.
    - `name` string, required: Tracking display name.
    - `status` string, required: Tracking status.
    - `type` string, required: Tracking type.
    - `startDate` string, required: Tracking start date.
    - `endDate` string: Tracking end date when set.
    - `createdFrom` string, required: Origin of the tracking.
  - `pagination` object, required: Pagination metadata.
    - `page` integer, required
    - `limit` integer, required
    - `total` integer, required
    - `totalPages` integer, required

## Other responses

- `400`: Invalid request payload or validation failed.
- `401`: Missing or invalid API token.
- `403`: The requested capability is not enabled for this brand plan.
- `429`: Request rate exceeded (short-term throttle) or daily organization quota exhausted. `error.code` is `RATE_LIMIT_EXCEEDED` for throttling (may include `Retry-After`) or `QUOTA_EXCEEDED` when the daily quota is used up.
- `502`: The API could not complete the request.
- `503`: Service temporarily unavailable.
- `504`: The request timed out.

---

[API](https://skmtc.dev/influencity/apis/influencity-api.md) - [All operations](https://skmtc.dev/influencity/apis/influencity-api/llms.txt) - [OpenAPI document](https://skmtc.dev/influencity/apis/influencity-api/revisions/827263990edf?raw)