List events

Python (SDK)

from latitudesh_python_sdk import Latitudesh
import os


with Latitudesh(
    bearer=os.getenv("LATITUDESH_BEARER", ""),
) as latitudesh:

    res = latitudesh.events.list(page_size=20, page_number=1)

    while res is not None:
        # Handle items

        res = res.next()

package main

import(
	"context"
	"os"
	latitudeshgosdk "github.com/latitudesh/latitudesh-go-sdk"
	"github.com/latitudesh/latitudesh-go-sdk/models/operations"
	"log"
)

func main() {
    ctx := context.Background()

    s := latitudeshgosdk.New(
        latitudeshgosdk.WithSecurity(os.Getenv("LATITUDESH_BEARER")),
    )

    res, err := s.Events.List(ctx, operations.GetEventsRequest{})
    if err != nil {
        log.Fatal(err)
    }
    if res.Events != nil {
        for {
            // handle items

            res, err = res.Next()

            if err != nil {
                // handle error
            }

            if res == nil {
                break
            }
        }
    }
}

import { Latitudesh } from "latitudesh-typescript-sdk";

const latitudesh = new Latitudesh({
  bearer: process.env["LATITUDESH_BEARER"] ?? "",
});

async function run() {
  const result = await latitudesh.events.list({});

  for await (const page of result) {
    console.log(page);
  }
}

run();

curl --request GET \
  --url https://api.latitude.sh/events \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.latitude.sh/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.latitude.sh/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.get("https://api.latitude.sh/events")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.latitude.sh/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "evt_r0MK4O4kDa95w",
      "type": "events",
      "attributes": {
        "created_at": "2026-01-14T15:56:32+00:00",
        "action": "user_data.create",
        "target": {
          "id": "ud_QraYDPm5OpjwW",
          "name": "user_data"
        },
        "project": {
          "id": "proj_Av9BVDavORm1W",
          "name": "Enormous Rubber Car",
          "slug": "enormous-rubber-car"
        },
        "team": {
          "id": "team_5EkwwB3BV5Uzo9EpPom8T6Zk6MjG",
          "name": "55 Team"
        },
        "author": {
          "id": "user_1P7kNv94QNtKXLZWMe42hNJ5x6V",
          "name": "Julian Kuvalis",
          "email": "aleshia@stiedemann.test"
        }
      }
    }
  ],
  "meta": {}
}

GET

events

Python (SDK)

from latitudesh_python_sdk import Latitudesh
import os


with Latitudesh(
    bearer=os.getenv("LATITUDESH_BEARER", ""),
) as latitudesh:

    res = latitudesh.events.list(page_size=20, page_number=1)

    while res is not None:
        # Handle items

        res = res.next()

package main

import(
	"context"
	"os"
	latitudeshgosdk "github.com/latitudesh/latitudesh-go-sdk"
	"github.com/latitudesh/latitudesh-go-sdk/models/operations"
	"log"
)

func main() {
    ctx := context.Background()

    s := latitudeshgosdk.New(
        latitudeshgosdk.WithSecurity(os.Getenv("LATITUDESH_BEARER")),
    )

    res, err := s.Events.List(ctx, operations.GetEventsRequest{})
    if err != nil {
        log.Fatal(err)
    }
    if res.Events != nil {
        for {
            // handle items

            res, err = res.Next()

            if err != nil {
                // handle error
            }

            if res == nil {
                break
            }
        }
    }
}

import { Latitudesh } from "latitudesh-typescript-sdk";

const latitudesh = new Latitudesh({
  bearer: process.env["LATITUDESH_BEARER"] ?? "",
});

async function run() {
  const result = await latitudesh.events.list({});

  for await (const page of result) {
    console.log(page);
  }
}

run();

curl --request GET \
  --url https://api.latitude.sh/events \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.latitude.sh/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.latitude.sh/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.get("https://api.latitude.sh/events")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.latitude.sh/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "evt_r0MK4O4kDa95w",
      "type": "events",
      "attributes": {
        "created_at": "2026-01-14T15:56:32+00:00",
        "action": "user_data.create",
        "target": {
          "id": "ud_QraYDPm5OpjwW",
          "name": "user_data"
        },
        "project": {
          "id": "proj_Av9BVDavORm1W",
          "name": "Enormous Rubber Car",
          "slug": "enormous-rubber-car"
        },
        "team": {
          "id": "team_5EkwwB3BV5Uzo9EpPom8T6Zk6MjG",
          "name": "55 Team"
        },
        "author": {
          "id": "user_1P7kNv94QNtKXLZWMe42hNJ5x6V",
          "name": "Julian Kuvalis",
          "email": "aleshia@stiedemann.test"
        }
      }
    }
  ],
  "meta": {}
}

Authorizations

Authorization

string

header

required

Query Parameters

filter[author]

string

The author ID or email to filter by

filter[project]

string

The project ID to filter by

filter[target_name]

string[]

The target type(s) of the event to filter by

filter[target_id]

string

The target id of the event to filter by

filter[action]

string

The action performed in event to filter by

filter[created_at][gte]

string

The created at greater than equal date to filter by, in ISO formatting (yyyy-MM-dd'T'HH:mm:ss)

filter[created_at][lte]

string

The created at less than equal date to filter by, in ISO formatting (yyyy-MM-dd'T'HH:mm:ss)

filter[created_at]

string[]

The created at between date range date1, date2 (inclusive) to filter by, in ISO formatting (yyyy-MM-dd'T'HH:mm:ss)

page[size]

integer

default:20

Number of items to return per page

Required range: x >= 1

page[number]

integer

default:1

Page number to return (starts at 1)

Required range: x >= 1

stats[total]

string

Request aggregate stats in the response meta. Use count to get the total number of records, returned as meta.stats.total.count.

sort

string

Comma-separated sort fields. Prefix a field with - for descending order. Supported fields: created_at. Example: sort=-created_at sorts by creation date descending.

Response

200 - application/vnd.api+json

Success

data

object[]

Show child attributes

Introduction

Endpoints

Authorizations

Query Parameters

Response