List Events

# Basic request with only required parameters
curl -G "https://app.cometly.com/public-api/v1/events" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d "start_date=2024-01-01 00:00:00" \
  -d "end_date=2024-01-31 23:59:59"

# Request with attribution filtering and specific fields
curl -G "https://app.cometly.com/public-api/v1/events" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d "start_date=2024-01-01 00:00:00" \
  -d "end_date=2024-01-31 23:59:59" \
  -d "query_mode=profile" \
  -d "event_names[]=purchase" \
  -d "event_names[]=sign_up" \
  -d "sources[]=facebook_ads" \
  -d "sources[]=google_ads" \
  -d "attribution_model=last_touch" \
  -d "attribution_window=30" \
  -d "fields[]=id" \
  -d "fields[]=event_name" \
  -d "fields[]=amount" \
  -d "fields[]=event_time_utc" \
  -d "per_page=100"

# Filter events by the owning contact's custom field value
curl -G "https://app.cometly.com/public-api/v1/events" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d "start_date=2024-01-01 00:00:00" \
  -d "end_date=2024-01-31 23:59:59" \
  -d "event_names[]=purchase" \
  -d "custom_field_filters[0][field]=profile_field_5" \
  -d "custom_field_filters[0][operator]=equal_to" \
  -d "custom_field_filters[0][value]=Premium"

# Pagination request using cursor
curl -G "https://app.cometly.com/public-api/v1/events" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d "start_date=2024-01-01 00:00:00" \
  -d "end_date=2024-01-31 23:59:59" \
  -d "cursor=eyJldmVudF90aW1lX3V0YyI6IjIwMjQtMDEtMTUgMTI..."

// Basic request with only required parameters
const params = new URLSearchParams({
  start_date: '2024-01-01 00:00:00',
  end_date: '2024-01-31 23:59:59'
});

const response = await fetch(`https://app.cometly.com/public-api/v1/events?${params}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();

// Request with attribution filtering and specific fields
const advancedParams = new URLSearchParams({
  start_date: '2024-01-01 00:00:00',
  end_date: '2024-01-31 23:59:59',
  query_mode: 'profile',
  attribution_model: 'last_touch',
  attribution_window: '30',
  per_page: '100'
});

// Add array parameters
['purchase', 'sign_up'].forEach(eventName =>
  advancedParams.append('event_names[]', eventName)
);

['facebook_ads', 'google_ads'].forEach(source =>
  advancedParams.append('sources[]', source)
);

['id', 'event_name', 'amount', 'event_time_utc'].forEach(field =>
  advancedParams.append('fields[]', field)
);

const advancedResponse = await fetch(`https://app.cometly.com/public-api/v1/events?${advancedParams}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  }
});

const advancedData = await advancedResponse.json();

// Pagination using cursor from previous response
if (advancedData.next_cursor) {
  const nextParams = new URLSearchParams({
    start_date: '2024-01-01 00:00:00',
    end_date: '2024-01-31 23:59:59',
    cursor: advancedData.next_cursor
  });

  const nextPage = await fetch(`https://app.cometly.com/public-api/v1/events?${nextParams}`, {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Accept': 'application/json',
      'Content-Type': 'application/json'
    }
  });
}

<?php
// Basic request with only required parameters
$baseUrl = 'https://app.cometly.com/public-api/v1/events';
$params = http_build_query([
    'start_date' => '2024-01-01 00:00:00',
    'end_date' => '2024-01-31 23:59:59'
]);

$headers = [
    'Authorization: Bearer YOUR_API_KEY',
    'Accept: application/json',
    'Content-Type: application/json'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $baseUrl . '?' . $params);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

// Request with attribution filtering and specific fields
$advancedParams = [
    'start_date' => '2024-01-01 00:00:00',
    'end_date' => '2024-01-31 23:59:59',
    'query_mode' => 'profile',
    'event_names' => ['purchase', 'sign_up'],
    'sources' => ['facebook_ads', 'google_ads'],
    'attribution_model' => 'last_touch',
    'attribution_window' => 30,
    'fields' => ['id', 'event_name', 'amount', 'event_time_utc'],
    'per_page' => 100
];

$queryString = http_build_query($advancedParams);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $baseUrl . '?' . $queryString);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

// Pagination using cursor
if (!empty($data['next_cursor'])) {
    $nextParams = http_build_query([
        'start_date' => '2024-01-01 00:00:00',
        'end_date' => '2024-01-31 23:59:59',
        'cursor' => $data['next_cursor']
    ]);

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $baseUrl . '?' . $nextParams);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    $nextResponse = curl_exec($ch);
    curl_close($ch);
}
?>

import requests
from urllib.parse import urlencode

# Basic request with only required parameters
base_url = 'https://app.cometly.com/public-api/v1/events'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
}

params = {
    'start_date': '2024-01-01 00:00:00',
    'end_date': '2024-01-31 23:59:59'
}

response = requests.get(base_url, headers=headers, params=params)
data = response.json()

# Request with attribution filtering and specific fields
advanced_params = {
    'start_date': '2024-01-01 00:00:00',
    'end_date': '2024-01-31 23:59:59',
    'query_mode': 'profile',
    'event_names[]': ['purchase', 'sign_up'],
    'sources[]': ['facebook_ads', 'google_ads'],
    'attribution_model': 'last_touch',
    'attribution_window': 30,
    'fields[]': ['id', 'event_name', 'amount', 'event_time_utc'],
    'per_page': 100
}

response = requests.get(base_url, headers=headers, params=advanced_params)
data = response.json()

# Pagination using cursor from previous response
if data.get('next_cursor'):
    next_params = {
        'start_date': '2024-01-01 00:00:00',
        'end_date': '2024-01-31 23:59:59',
        'cursor': data['next_cursor']
    }

    next_response = requests.get(base_url, headers=headers, params=next_params)
    next_data = next_response.json()