Export payment transactions

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/payments/analytics/transactions/export \
  --header 'Authorization: Bearer <token>'

import requests

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

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}/payments/analytics/transactions/export', 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}/payments/analytics/transactions/export",
  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}/payments/analytics/transactions/export"

	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}/payments/analytics/transactions/export")

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

"Date","Customer","Transaction ID","Status","Amount","Currency"
"2026-08-25 10:00:00","Jane Doe","pi_T7mK2p9Q4r6S8v","succeeded","25.00","USD"

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

Transactions

Export payment transactions

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

Downloads the app’s payments, refunds, and lost disputes for one payment provider as a CSV file, newest first.

The file starts with a header row, then has one row per transaction with these columns:

Date: The transaction time in UTC as the analytics store records it, for example 2026-08-25 10:00:00
Customer: The customer’s name or email, or the provider’s customer ID when neither can be resolved
Transaction ID: The provider’s ID for the transaction
Status: Either succeeded, refunded, or failed
Amount: In the currency’s major unit, so 25.00 rather than 2500
Currency: An uppercase three-letter ISO 4217 code

Cells are quoted, and cells a spreadsheet would read as a formula start with '.

The file covers the app’s whole history unless you pass period or both start_date and end_date. It stops at 10,000 rows without saying so in the file, so narrow the window when a download reaches that size.

Customer names are looked up from the provider within a 20-second budget for the whole file, so a large export can leave some Customer cells with only an ID, or empty.

The file includes one mode per provider:

Stripe: Live when the app’s stored key is a live key, test otherwise.
Wix Payments: Live, unless test-mode reporting is enabled for your account. Then it follows the app’s Wix Payments test-mode setting.

Results come from an analytics store and can lag behind the payment provider.

This endpoint accepts a personal access token belonging to a user with write access to the app. A read-only personal access token is refused, and so is a viewer.

GET

api

apps

{app_id}

payments

analytics

transactions

export

Export payment transactions

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/payments/analytics/transactions/export \
  --header 'Authorization: Bearer <token>'

import requests

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

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}/payments/analytics/transactions/export', 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}/payments/analytics/transactions/export",
  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}/payments/analytics/transactions/export"

	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}/payments/analytics/transactions/export")

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

"Date","Customer","Transaction ID","Status","Amount","Currency"
"2026-08-25 10:00:00","Jane Doe","pi_T7mK2p9Q4r6S8v","succeeded","25.00","USD"

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

Authorizations

Authorization

string

header

required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Path Parameters

app_id

string

required

ID of the Base44 app.

Query Parameters

start_date

string<date-time>

Start of the window as an ISO 8601 timestamp. Send it with end_date, because a date sent on its own is ignored.

end_date

string<date-time>

End of the window as an ISO 8601 timestamp. Send it with start_date.

period

enum<string>

Window to use when you don't send both dates, counted back over whole UTC days including today. Either 7d, 30d, or 90d. Defaults to no window, which covers the app's whole history.

Available options:

7d,

30d,

90d

currencies

string

Comma-separated currency codes, for example usd,eur. Defaults to no currency filter.

provider

enum<string>

required

Payment provider whose transactions to use. Either stripe or wix. stripe covers payments taken through the app's Stripe integration, and wix covers payments taken through Wix Payments (Base44 Payments). The provider has to be connected to the app.

Available options:

stripe,

wix

status

string

Comma-separated statuses to include, from succeeded, refunded, and failed. For example, succeeded,refunded leaves out lost disputes. Defaults to every status.

Response

The CSV file, sent as an attachment named after the app and today's date.

The response is of type string.

Base44 APIs

Apps API (Beta)

Workspace API (Beta)

Superagents API (Beta)

Monitoring API

Audit Logs API

Outbound webhooks

Export payment transactions

Authorizations

Path Parameters

Query Parameters

Response