---
title: "Get recent payment transactions"
method: GET
path: "/api/apps/{app_id}/payments/analytics/recent-transactions"
---

# Get recent payment transactions

`GET /api/apps/{app_id}/payments/analytics/recent-transactions`

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

Returns the app's most recent payments, refunds, and disputes, newest first.

Without a provider filter, this list spans every connected provider but only attempts customer enrichment against Stripe, so Wix customers may come back without a name or email. Filtering to one provider needs the extra access `provider` describes.

Send `start_date` and `end_date` together to set a window. With neither, or only one of the two, `period` selects the last 7, 30, or 90 whole UTC days including today.

Returns a single batch of up to `limit` records, with no cursor to retrieve the rest.

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

Requires read access to the app.

## Path parameters

- `app_id` string, required — ID of the Base44 app.

## Query parameters

- `start_date` string, date-time, nullable — Start of the window as an ISO 8601 timestamp. Send with end_date. Defaults to the period window.
- `end_date` string, date-time, nullable — End of the window as an ISO 8601 timestamp. Send with start_date. Defaults to now when using period.
- `period` '7d' | '30d' | '90d' — Fallback window. Either `7d`, `30d`, or `90d`. Defaults to `30d`. Used unless both dates are supplied.
- `limit` integer — Maximum transactions to return, from 1 through 10. Defaults to 7.
- `currencies` string, nullable — Comma-separated currency codes, for example `usd,eur`. Defaults to no currency filter. Use one currency when comparing amounts.

## Response `200`

Successful Response

- RecentTransactionsResponse — Response with recent transactions list.
  - `transactions` RecentTransactionResponse[], required — Recent payments, refunds, and disputes, newest first. Empty when none match.
    - `timestamp` string, required — Transaction time in UTC as returned by the analytics store. The string can omit an explicit timezone offset.
    - `action` string, required — What this entry represents. Either `payment`, `refund`, or `dispute_lost`.
    - `status` string — Display status derived from the action. `payment` becomes `succeeded`, `refund` becomes `refunded`, and `dispute_lost` becomes `failed`. Other actions retain their action value. Defaults to an empty string.
    - `amount` integer — Amount in the currency's smallest unit. Read `action` to tell an incoming payment from an outgoing refund or dispute loss. Defaults to `0`.
    - `currency` string — Currency code recorded with the transaction. Defaults to `usd`.
    - `customer_id` string, nullable — Provider customer ID, or `null` when none was recorded. Defaults to `null`.
    - `transaction_id` string, nullable — Provider transaction ID, or `null` when none was recorded. Defaults to `null`.
    - `customer_name` string, nullable — Customer name when provider enrichment succeeds, or `null` when unavailable. Defaults to `null`.
    - `customer_email` string, nullable — Customer email when provider enrichment succeeds, or `null` when unavailable. Defaults to `null`.
    - `is_live` boolean — Whether this entry was recorded in live mode. Defaults to `true`.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have access to this app, or the app does not exist. A missing app and an app you cannot reach are deliberately the same answer.
- `404` — The app is outside the credential grant, or a provider-scoped request is outside the dashboard rollout or has no connected provider.
- `409` — The workspace requires an unlocked SSO session.
- `422` — Validation Error

## Changes

- **2026-09-15** `ca10c5ce328c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/base44/apis/base44-app-management-api/changes/api/apps/:app_id/payments/analytics/recent-transactions/get.md)

---

[API](https://skmtc.dev/base44/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/base44/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/base44/apis/base44-app-management-api/revisions/cf164639a9bf?raw)