---
title: "Get affiliate timelines"
method: GET
path: "/v2/affiliation/{userId}/timelines"
tags: ["Affiliations"]
---

# Get affiliate timelines

`GET /v2/affiliation/{userId}/timelines`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/affiliation/{userId}/timelines`
- Auth: none declared

Returns a daily time series for the specified metric (signups, clicks, or paid_users) within a date range.

## Path parameters

- `userId` integer, required

## Query parameters

- `from` string, required
- `to` string, required
- `timezone` string
- `metric` string, required

## Response `200`

Timeline data retrieved successfully

- JsonOkListResponseTimelineSeries
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` TimelineSeries[]
    - `metric` string
    - `values` SeriesValue[]
      - `dateTime` string, date-time
      - `value` number, double
    - `aggregate` TimelineAggregate
      - `aggregation` string
      - `value` number, double

## Other responses

- `400`: Unsupported metric provided
- `403`: User not authorized or affiliate is banned

---

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