v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB
platformApi

Api Points Transactions List List

GET /api/points-transactions/list/ POST /api/points-transactions/list/ (POST-for-Filtering) List Respan Points transactions for the caller's own organization.

Own-org only — including superadmins. Reads are scoped by ProjectScopedQuerysetMixin to the request org's unique_organization_id; there is NO superadmin ?org= cross-org override (dropped to eliminate the cross-tenant leak / unknown-org bug class). Cross-org points administration goes through the CREATE endpoint, which still resolves a target org via get_target_organization().

NOTE: CLICKHOUSE-ONLY — reads ch_billing_event points-class rows.

get/api/points-transactions/list/

Query parameters

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

Headers

Authorizationstring required

JWT access token or Respan API key

Response

countinteger required
nextstring uri nullable
previousstring uri nullable
total_countinteger
current_filtersFilterParamDictPydantic

Pydantic model for FilterParamDict. A dictionary that maps metric names to their filter parameters.

Each key is a metric name (str), and each value can be:

  • A single MetricFilterParamPydantic (one condition)
  • A List[MetricFilterParamPydantic] (multiple conditions for same metric)
  • A FilterBundlePydantic (nested filter bundle with connector)

Note: Uses extra="allow" for dynamic metric name fields. The pydantic_extra annotation tells Pydantic what types to expect for extra fields, and generates typed additionalProperties in JSON Schema.

filters_dataPaginatedPointsTransactionListListFiltersData