List Sessions

curl --request GET \
  --url https://api-sandbox.letshum.com/analytics/sessions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api-sandbox.letshum.com/analytics/sessions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api-sandbox.letshum.com/analytics/sessions', 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-sandbox.letshum.com/analytics/sessions",
  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: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.letshum.com/analytics/sessions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api-sandbox.letshum.com/analytics/sessions")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.letshum.com/analytics/sessions")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "message": "Analytics sessions",
  "request_status": "ok",
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "created_at": "2026-03-01T12:00:00Z",
      "campaign_id": "spring_promo_2026",
      "address": {
        "street1": "123 Main St",
        "street2": "Apt 4B",
        "city": "Detroit",
        "state": "MI",
        "zip": "48201"
      },
      "furthest_step": 6,
      "order_number": "HUM-A1B2C3D4",
      "status": "complete",
      "ordered_at": "2026-03-01T12:30:00Z",
      "installed": true,
      "installed_at": "2026-03-05T14:00:00Z",
      "commission_cents": 5000
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "created_at": "2026-03-01T11:00:00Z",
      "campaign_id": null,
      "address": {
        "street1": "456 Oak Ave",
        "street2": null,
        "city": "Ann Arbor",
        "state": "MI",
        "zip": "48104"
      },
      "furthest_step": 3,
      "order_number": null,
      "status": null,
      "ordered_at": null,
      "installed": null,
      "installed_at": null,
      "commission_cents": null
    }
  ],
  "meta": {
    "responded_at": "2026-03-12T15:00:00Z",
    "page": 1,
    "pages": 5,
    "count": 237
  }
}

Analytics

List Sessions

Returns a paginated list of sessions with address, cart progression, order, and commission data. Scoped to all tokens belonging to the authenticated client.

Filtering

start_date / end_date: ISO 8601 date strings to bound the query window
updated_since: Return only sessions whose session or order data changed on or after this time; results are ordered by most recent change first
token_ids[]: Restrict to specific API tokens (must belong to your account)
with_clicks: When true, only returns sessions with click activity

Pagination

Results are paginated at 50 sessions per page. Use the page parameter and the meta.pages field to navigate.

Syncing order status

To keep a local copy of order status current, poll with updated_since set to the time of your last successful sync and page through all results. A session is returned whenever the session or its order changed — including installs, cancellations, and commission updates on sessions created long ago. Treat each returned row as authoritative and overwrite your stored copy. Do not use start_date as a sync cursor: it filters on session creation time, so status changes on previously synced sessions are never returned. Unrecognized parameters are ignored.

GET

analytics

sessions

List Sessions

curl --request GET \
  --url https://api-sandbox.letshum.com/analytics/sessions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api-sandbox.letshum.com/analytics/sessions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api-sandbox.letshum.com/analytics/sessions', 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-sandbox.letshum.com/analytics/sessions",
  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: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.letshum.com/analytics/sessions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api-sandbox.letshum.com/analytics/sessions")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.letshum.com/analytics/sessions")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "message": "Analytics sessions",
  "request_status": "ok",
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "created_at": "2026-03-01T12:00:00Z",
      "campaign_id": "spring_promo_2026",
      "address": {
        "street1": "123 Main St",
        "street2": "Apt 4B",
        "city": "Detroit",
        "state": "MI",
        "zip": "48201"
      },
      "furthest_step": 6,
      "order_number": "HUM-A1B2C3D4",
      "status": "complete",
      "ordered_at": "2026-03-01T12:30:00Z",
      "installed": true,
      "installed_at": "2026-03-05T14:00:00Z",
      "commission_cents": 5000
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "created_at": "2026-03-01T11:00:00Z",
      "campaign_id": null,
      "address": {
        "street1": "456 Oak Ave",
        "street2": null,
        "city": "Ann Arbor",
        "state": "MI",
        "zip": "48104"
      },
      "furthest_step": 3,
      "order_number": null,
      "status": null,
      "ordered_at": null,
      "installed": null,
      "installed_at": null,
      "commission_cents": null
    }
  ],
  "meta": {
    "responded_at": "2026-03-12T15:00:00Z",
    "page": 1,
    "pages": 5,
    "count": 237
  }
}

Authorizations

Authorization

string

header

required

Bearer token authentication using API tokens. Include the token in the Authorization header as: Authorization: Bearer <token>

Obtain tokens from your Hum representative or contact support@letshum.com. There is no self-serve API key dashboard.

Query Parameters

page

integer

default:1

Page number (default 1, 50 results per page)

Required range: x >= 1

Example:

1

start_date

string<date-time>

Filter sessions created on or after this date (ISO 8601)

Example:

"2026-01-01T00:00:00Z"

end_date

string<date-time>

Filter sessions created on or before this date (ISO 8601)

Example:

"2026-03-31T23:59:59Z"

updated_since

string<date-time>

Return only sessions whose session or order data changed on or after this time (ISO 8601). When provided, results are ordered by most recent change first. Invalid datetime values are ignored.

Example:

"2026-03-10T00:00:00Z"

token_ids[]

string<uuid>[]

Filter to sessions from specific API tokens. All provided token IDs must belong to the authenticated client or a 403 is returned.

with_clicks

boolean

default:false

When true, only return sessions that have click activity

Response

Paginated list of analytics sessions

message

string

required

A message returned by the API. Includes a human-readable message about the status of the request.

Example:

"What happened in the most recent request."

request_status

enum<string>

required

An informational summary returned in API response bodies: ok for successful responses, warning for standard request errors, and error for endpoint-specific failures. Integrations must use the HTTP status code, not request_status, to determine whether a request succeeded.

Available options:

ok,

warning,

error

Example:

"ok"

data

object[]

required

Show child attributes

Sessions

Service Availability

Health Check

Informational

Analytics

List Sessions

Filtering

Pagination

Syncing order status

Authorizations

Query Parameters

Response