Banking Activities

The Banking Activities API provides search access to institution-scoped activity records, including authentication events, MFA actions, payment activity, audit events, and related operational activity. Results are returned in batches with pagination and flexible filtering across users, events, and request-context attributes.

End-user benefits

• Retrieve activity events within a required startTime and endTime window (up to a 90‑day lookback).
• Page through large result sets using pageSize and nextPageToken.
• Scope activity results to retail or business users, companies, event identifiers, or attribute-level conditions without accessing raw log data.

Integration capabilities

• Search activities using SearchCriteria request body; requires ISO 8601 startTime and endTime; startTime must be strictly earlier than endTime.
• Filter results by eventIds, eventType (user or system), userType (retail or business), userId / userIdType, and companyId.
• Apply advanced additionalFilters with AND/OR groupings across request-context attributes.
• Reduce response payloads with requestedAttributes and continue queries using an opaque nextPageToken.
• Returns matching bankingActivities records (gzip-encoded); responds with HTTP 204 when no records match.

Scopes

Scope	Description
banking-activities:read	Read banking activities

Required headers

Header	Description
Authorization	Bearer {token} (OAuth V2)
transactionId	UUID used to trace and correlate requests across services for debugging and logging.

Error codes (BAS_*)

Code	Message	HTTP Status Code
BAS_10001	The given start date must be earlier than end Date.	400
BAS_10002	The given start date must be within last three months.	400
BAS_10003	BigTable connection failed.	500
BAS_10004	BigTable rows could not be read.	500
BAS_10005	Invalid arguments passed in the request; Failed to read HTTP message	400
BAS_10006	Http Message not readable	400
BAS_10007	NOT EQUAL and LIKE criterias not supported at this time.	400
BAS_10008	Additional filters condition and sub filter condition cannot be the same.	400
BAS_10009	Invalid UserType requested.	400
BAS_10010	Invalid UserIdType requested.	400
BAS_10011	UserIdType must be present if userId is given.	400
BAS_10012	Invalid EventType requested.	400
BAS_10021	BigTable Query is invalid.	400
BAS_10022	Row key is unexpectedly empty.	400
BAS_10101	Full authentication was not provided in the request.	401 or 403
BAS_10102	Authentication token sent in the request is invalid.	401
BAS_10103	The authentication provided does not authorize this request.	400
BAS_10104	The jwt token is invalid.	401
BAS_10105	Unauthorized access.	400
BAS_10201	Request should only contain printable ASCII characters	400
BAS_10202	transactionId header is too long	400
BAS_10203	One or more header values are invalid	400
BAS_10204	Invalid Request body	400
BAS_10205	One or more header values are too long	400
BAS_10206	nextPageToken is invalid	400
BAS_10207	Requested method type is invalid	400
BAS_99999	Internal server error	500

Endpoints

Search Banking Activities

Searches and returns a page of banking activity records for the institution. The service