List test runs

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/testing-agent/executions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/testing-agent/executions"

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

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

print(response.text)

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

fetch('https://app.base44.com/api/apps/{app_id}/testing-agent/executions', 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}/testing-agent/executions",
  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://app.base44.com/api/apps/{app_id}/testing-agent/executions"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/testing-agent/executions")

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

[
  {
    "id": "68a1c9b7f0b3d9001a7e5d04",
    "app_id": "6820f3a4e7b91d003c45a1f2",
    "flow_id": "68a1c2e4f0b3d9001a7e5c21",
    "flow_goal": "Sign up, create a project called Launch, and check that it appears on the dashboard.",
    "flow_role": "admin",
    "site_url": "https://preview-6820f3a4e7b91d003c45a1f2.base44.app/?_preview_token=FH-j7wHS7IR_fC1tUh4wCd_fNV1XGC479cuqNSYi9mA",
    "status": "success",
    "actions": [
      {
        "step_summary": "Clicked Sign up in the header to reach the registration form.",
        "step_title": "Opened the sign-up form"
      }
    ],
    "result_message": "Created the project and found it on the dashboard.",
    "goal_accomplished": true,
    "live_status": "Analyzing results",
    "analysis_status": "completed",
    "failure_reason": "app",
    "credits_charged": 1.5,
    "started_at": "2026-09-28T10:16:02+00:00",
    "completed_at": "2026-09-28T10:18:40+00:00",
    "created_date": "2026-09-28T10:16:00+00:00",
    "updated_date": "2026-09-28T10:18:40+00:00"
  }
]

Testing

List test runs

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

Returns the app’s 100 most recent test runs, newest first. Set flow_id to get only one test’s runs. Older runs can’t be listed.

This is limited to 6000 requests per minute per caller for each app. Some workspaces have a different limit.

This endpoint accepts a personal API key belonging to a user with access to the app. Read-only keys are refused even though this endpoint only reads, and workspace API keys are not accepted.

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

GET

api

apps

{app_id}

testing-agent

executions

List test runs

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/testing-agent/executions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/testing-agent/executions"

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

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

print(response.text)

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

fetch('https://app.base44.com/api/apps/{app_id}/testing-agent/executions', 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}/testing-agent/executions",
  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://app.base44.com/api/apps/{app_id}/testing-agent/executions"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/testing-agent/executions")

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

[
  {
    "id": "68a1c9b7f0b3d9001a7e5d04",
    "app_id": "6820f3a4e7b91d003c45a1f2",
    "flow_id": "68a1c2e4f0b3d9001a7e5c21",
    "flow_goal": "Sign up, create a project called Launch, and check that it appears on the dashboard.",
    "flow_role": "admin",
    "site_url": "https://preview-6820f3a4e7b91d003c45a1f2.base44.app/?_preview_token=FH-j7wHS7IR_fC1tUh4wCd_fNV1XGC479cuqNSYi9mA",
    "status": "success",
    "actions": [
      {
        "step_summary": "Clicked Sign up in the header to reach the registration form.",
        "step_title": "Opened the sign-up form"
      }
    ],
    "result_message": "Created the project and found it on the dashboard.",
    "goal_accomplished": true,
    "live_status": "Analyzing results",
    "analysis_status": "completed",
    "failure_reason": "app",
    "credits_charged": 1.5,
    "started_at": "2026-09-28T10:16:02+00:00",
    "completed_at": "2026-09-28T10:18:40+00:00",
    "created_date": "2026-09-28T10:16:00+00:00",
    "updated_date": "2026-09-28T10:18:40+00:00"
  }
]

Authorizations

Authorization

string

header

required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id

string

required

ID of the app.

Query Parameters

flow_id

string | null

Only return runs of this test.

Response

The runs, newest first.

string

required

ID of the run.

Example:

"68a1c9b7f0b3d9001a7e5d04"

app_id

string

required

ID of the app.

Example:

"6820f3a4e7b91d003c45a1f2"

flow_id

string

required

ID of the test this run belongs to.

Example:

"68a1c2e4f0b3d9001a7e5c21"

flow_goal

string

required

The test's goal when the run started.

Example:

"Sign up, create a project called Launch, and check that it appears on the dashboard."

flow_role

string | null

required

Role the run signs in as, including one Base44 picked from the test's name or goal. Set once the run starts. null when the run uses no role.

Example:

"admin"

site_url

string

required

URL the run opened.

Example:

"https://preview-6820f3a4e7b91d003c45a1f2.base44.app/?_preview_token=FH-j7wHS7IR_fC1tUh4wCd_fNV1XGC479cuqNSYi9mA"

status

enum<string>

required

Where the run is. pending, running and analyzing mean it's still going. success means the browser session finished, and failed means it didn't. timeout, cancelled and paused mean the run stopped early. The test passed when goal_accomplished is true and failure_reason isn't platform or internal.

Available options:

pending,

running,

analyzing,

success,

failed,

timeout,

cancelled,

paused

Example:

"success"

actions

TestRunStep · object[]

required

Steps the agent took. Empty until the run finishes.

Show child attributes

Example:

[
  {
    "step_summary": "Clicked Sign up in the header to reach the registration form.",
    "step_title": "Opened the sign-up form"
  }
]

result_message

string | null

required

The agent's account of how the run went, or null before the run finishes.

Example:

"Created the project and found it on the dashboard."

goal_accomplished

boolean | null

required

Whether the agent accomplished the goal, or null before the run finishes. Can be true on a run whose failure_reason is platform or internal, which counts as a technical failure.

Example:

true

live_status

string | null

required

Short progress message for display, or null before the run starts.

Example:

"Analyzing results"

analysis_status

enum<string> | null

required

Progress of the run's report. completed means Get test run report has it. null before the run reaches analysis.

Available options:

pending,

completed,

failed

Example:

"completed"

failure_reason

enum<string> | null

required

Why the run didn't pass, or null when no reason was recorded. app is a problem in your app. platform and internal are problems on Base44's side, so rerun the test. out_of_credits comes with status paused.

Available options:

app,

platform,

internal,

out_of_credits

Example:

"app"

credits_charged

number | null

required

Credits the run cost, or null before it's charged.

Example:

1.5

started_at

string | null

required

When the browser session started, as an ISO 8601 UTC timestamp, or null while pending.

Example:

"2026-09-28T10:16:02+00:00"

completed_at

string | null

required

When the run ended, as an ISO 8601 UTC timestamp, or null while it's still going.

Example:

"2026-09-28T10:18:40+00:00"

created_date

string

required

When the run was requested, as an ISO 8601 UTC timestamp.

Example:

"2026-09-28T10:16:00+00:00"

updated_date

string

required

When the run last changed, as an ISO 8601 UTC timestamp.

Example:

"2026-09-28T10:18:40+00:00"

Base44 APIs

Apps API (Beta)

Monitoring API

Audit Logs API

List test runs

Authorizations

Path Parameters

Query Parameters

Response