Query analytics events

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/analytics/query \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "event_name": "checkout_completed",
  "q": "{\"properties.plan\": {\"in\": [\"pro\", \"elite\"]}}",
  "offset": 0,
  "limit": 100
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/analytics/query"

payload = {
    "event_name": "checkout_completed",
    "q": "{\"properties.plan\": {\"in\": [\"pro\", \"elite\"]}}",
    "offset": 0,
    "limit": 100
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    event_name: 'checkout_completed',
    q: '{"properties.plan": {"in": ["pro", "elite"]}}',
    offset: 0,
    limit: 100
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/analytics/query', 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://app.base44.com/api/apps/{app_id}/analytics/query",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'event_name' => 'checkout_completed',
    'q' => '{"properties.plan": {"in": ["pro", "elite"]}}',
    'offset' => 0,
    'limit' => 100
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/analytics/query"

	payload := strings.NewReader("{\n  \"event_name\": \"checkout_completed\",\n  \"q\": \"{\\\"properties.plan\\\": {\\\"in\\\": [\\\"pro\\\", \\\"elite\\\"]}}\",\n  \"offset\": 0,\n  \"limit\": 100\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/analytics/query")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"event_name\": \"checkout_completed\",\n  \"q\": \"{\\\"properties.plan\\\": {\\\"in\\\": [\\\"pro\\\", \\\"elite\\\"]}}\",\n  \"offset\": 0,\n  \"limit\": 100\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/analytics/query")

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

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"event_name\": \"checkout_completed\",\n  \"q\": \"{\\\"properties.plan\\\": {\\\"in\\\": [\\\"pro\\\", \\\"elite\\\"]}}\",\n  \"offset\": 0,\n  \"limit\": 100\n}"

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

{
  "total": 1842,
  "events": [
    {
      "event_id": "4f1c9a02-8b7d-4e6a-9c31-5d2e7f8a0b41",
      "event_name": "checkout_completed",
      "metadata": {
        "country": "US",
        "device_type": "mobile",
        "os": "iOS"
      },
      "page_url": "https://my-crm.base44.app/checkout",
      "properties": {
        "plan": "pro",
        "amount": 49.9
      },
      "session_id": "9a7c2f10-3b4d-4e58-8c61-0d2f5a7b9e13",
      "timestamp": "2026-08-02T14:30:00",
      "user_id": "6891ab34d2f07e5c1b9a2d48"
    }
  ],
  "has_more": true,
  "next_offset": 100
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

API Reference

Query analytics events

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Returns the app’s individual analytics events for one event name, newest first, with the properties the app sent on each one.

The time range defaults to the last 7 days. To use a different range, put timestamp bounds in the q filter, for example {"timestamp": {"gte": "2026-08-01T00:00:00Z", "lt": "2026-08-08T00:00:00Z"}}. Base44 applies the bounds as timestamp >= start and timestamp < end, so gt behaves like gte and lte behaves like lt. Events are kept for 60 days, so an older range returns nothing.

Page through the results with limit and offset. When has_more is true, send the returned next_offset as the next request’s offset. total counts every matching event, not just the ones on this page.

q is a JSON object serialized to a string. Each key is a field, and its value is either a literal to match for equality or an object of operators, as in {"user_id": "6891ab34d2f07e5c1b9a2d48", "properties.amount": {"gte": 50}}. The comparison operators are eq, ne, gt, gte, lt, lte, in, nin, and regex. Combine expressions with and or or, each taking an array, and negate one with not.

event_id, event_name, timestamp, user_id, session_id, and page_url are top-level fields. Every other key reads as an event property, so plan and properties.plan mean the same thing. Get the available property keys from List analytics event properties. Prefix a key with metadata. to filter on the device information Base44 captures itself: metadata.device_type, metadata.os, and metadata.country.

regex matches a substring, not a regular expression. {"page_url": {"regex": "/checkout"}} matches any URL containing /checkout, and regular expression syntax such as ^ or .* matches literally. Add "options": "i" next to it for a case-insensitive match.

The response includes fields beyond the ones documented here. Don’t use any undocumented fields, as they can change at any time.

POST

api

apps

{app_id}

analytics

query

Query analytics events

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/analytics/query \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "event_name": "checkout_completed",
  "q": "{\"properties.plan\": {\"in\": [\"pro\", \"elite\"]}}",
  "offset": 0,
  "limit": 100
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/analytics/query"

payload = {
    "event_name": "checkout_completed",
    "q": "{\"properties.plan\": {\"in\": [\"pro\", \"elite\"]}}",
    "offset": 0,
    "limit": 100
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    event_name: 'checkout_completed',
    q: '{"properties.plan": {"in": ["pro", "elite"]}}',
    offset: 0,
    limit: 100
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/analytics/query', 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://app.base44.com/api/apps/{app_id}/analytics/query",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'event_name' => 'checkout_completed',
    'q' => '{"properties.plan": {"in": ["pro", "elite"]}}',
    'offset' => 0,
    'limit' => 100
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/analytics/query"

	payload := strings.NewReader("{\n  \"event_name\": \"checkout_completed\",\n  \"q\": \"{\\\"properties.plan\\\": {\\\"in\\\": [\\\"pro\\\", \\\"elite\\\"]}}\",\n  \"offset\": 0,\n  \"limit\": 100\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/analytics/query")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"event_name\": \"checkout_completed\",\n  \"q\": \"{\\\"properties.plan\\\": {\\\"in\\\": [\\\"pro\\\", \\\"elite\\\"]}}\",\n  \"offset\": 0,\n  \"limit\": 100\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/analytics/query")

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

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"event_name\": \"checkout_completed\",\n  \"q\": \"{\\\"properties.plan\\\": {\\\"in\\\": [\\\"pro\\\", \\\"elite\\\"]}}\",\n  \"offset\": 0,\n  \"limit\": 100\n}"

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

{
  "total": 1842,
  "events": [
    {
      "event_id": "4f1c9a02-8b7d-4e6a-9c31-5d2e7f8a0b41",
      "event_name": "checkout_completed",
      "metadata": {
        "country": "US",
        "device_type": "mobile",
        "os": "iOS"
      },
      "page_url": "https://my-crm.base44.app/checkout",
      "properties": {
        "plan": "pro",
        "amount": 49.9
      },
      "session_id": "9a7c2f10-3b4d-4e58-8c61-0d2f5a7b9e13",
      "timestamp": "2026-08-02T14:30:00",
      "user_id": "6891ab34d2f07e5c1b9a2d48"
    }
  ],
  "has_more": true,
  "next_offset": 100
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose analytics to read.

Body

application/json

Query request for analytics events with filter expression support.

event_name

string

required

Name of the event to query, exactly as the app tracked it.

Example:

"checkout_completed"

string | null

Filter expression, as a JSON object serialized to a string. Omit to return every event with this name in the time range.

Example:

"{\"properties.plan\": {\"in\": [\"pro\", \"elite\"]}}"

offset

integer

default:0

Number of events to skip before the page starts. Pass the next_offset from the previous response to get the next page.

Required range: x >= 0

Example:

0

limit

integer

default:100

Maximum number of events to return, between 1 and 1000.

Required range: 1 <= x <= 1000

Example:

100

Response

The matching events.

total

integer

required

Number of events matching the query, across all pages.

Example:

1842

events

AnalyticsEvent · object[]

required

The requested page of events, newest first.

Show child attributes

Example:

[
  {
    "event_id": "4f1c9a02-8b7d-4e6a-9c31-5d2e7f8a0b41",
    "event_name": "checkout_completed",
    "metadata": {
      "country": "US",
      "device_type": "mobile",
      "os": "iOS"
    },
    "page_url": "https://my-crm.base44.app/checkout",
    "properties": { "plan": "pro", "amount": 49.9 },
    "session_id": "9a7c2f10-3b4d-4e58-8c61-0d2f5a7b9e13",
    "timestamp": "2026-08-02T14:30:00",
    "user_id": "6891ab34d2f07e5c1b9a2d48"
  }
]

has_more

boolean

required

Whether more events match beyond this page.

Example:

true

next_offset

integer | null

Offset to pass as offset to get the next page, or null when has_more is false.

Example:

100

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Analytics API (Beta)

Monitoring API

Audit Logs API

Query analytics events

Authorizations

Path Parameters

Body

Response