Get campaign daily event timeline

GET /analytics/campaigns/{campaignId}/events

Authentication

Send your organization API key as a Bearer credential.

Authorization: Bearer YOUR_API_KEY

Path parameters

campaignId string required

Query parameters

period string

Allowed values: 7d, 1m, 3m, 6m, 1y, all

start_date string

end_date string

type string

Allowed values: event, cohort

Example: event

event_types string[]

Response

application/json

Campaign event timeline retrieved successfully

labels string[] required

Example: ["2026-08-01", "2026-08-02"]

series object[] required

Show child attributes Hide child attributes

series.name string required

Allowed values: sent, opened, replied, bounced

series.data number[] required

Example: [80, 45]

meta object required

Show child attributes Hide child attributes

meta.open_tracking_enabled boolean required

Whether opened metrics are available for this campaign and tracking domain

Example: true

Request

curl --request GET \
  --url https://developer.coldy.ai/api/v1/analytics/campaigns/{campaignId}/events \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json'

{
  "labels": [
    "2026-08-01",
    "2026-08-02"
  ],
  "series": [
    {
      "name": "sent",
      "data": [
        80,
        45
      ]
    }
  ],
  "meta": {
    "open_tracking_enabled": true
  }
}

{
  "message": [
    "You put invalid API key. Verify your key with the key from your account in Coldy. Check documenation for info"
  ],
  "statusCode": 400,
  "error": "Invalid API key"
}