---
title: "View activities for specific cards or over a date range"
method: GET
path: "/activities"
tags: ["Cards"]
---

# View activities for specific cards or over a date range

`GET /activities`

View activities for a specified list of cards and a given time frame. View activities for all cards belonging to a specified list of accounts and a given time frame. View all activities for a single card when a single card ID is specified, time frame is optional.

## Query parameters

- `fromCreatedDate` string
- `toCreatedDate` string
- `statuses` 'DECLINED' | 'APPROVED' | 'SETTLED' | 'EXPIRED' | 'APPLIED' | 'PENDING'
- `types` 'AUTHORISATION' | 'REVERSAL' | 'SETTLEMENT' | 'REFUND' | 'ORIGINAL_CREDIT' | 'OFFLINE_TRANSACTION' | 'ASI' | 'CREDIT_AUTH' | 'CREDIT_AUTH_REV'
- `cards` string[]
- `accounts` string[]
- `ids` string[]
- `orderId` integer
- `channelManagerId` string
- `sortFields` 'createdDate' | 'orderId'
- `sortOrders` 'ASC' | 'DESC'
- `page` integer
- `size` integer

## Response `200`

Card activity data returned successfully

- CardCardActivityPageResponse
  - `content` CardCardActivityResponse[], required — List of responses on the current page
    - `id` string, required — The card activity identifier. Maximum of 10 alphanumeric characters
    - `orderId` string, required — Order identifier which links together related authorisations, reversals & settlements. Maximum of 10 alphanumeric characters
    - `cardId` string, required — Card identifier. Maximum of 10 alphanumeric characters
    - `type` 'AUTHORISATION' | 'REVERSAL' | 'SETTLEMENT' | 'REFUND', required — Type of card activity
    - `status` 'DECLINED' | 'APPROVED' | 'SETTLED' | 'EXPIRED' — Status of card activity. Only applies to activities of type AUTHORISATION
    - `reason` string — The reason why this activity was declined. Only applies to activities with status DECLINED
    - `verifiedBy3DS` boolean — Whether the activity was 3DS enabled
    - `createdDate` string, date-time, required — The creation date of the card activity
    - `transactionAmount` number, required — The card activity transaction amount
    - `transactionCurrency` string, required — The 3 letter ISO 4217 card activity transaction currency
    - `billingAmount` number, required — The card activity billing amount
    - `billingCurrency` string, required — The 3 letter ISO 4217 card activity billing currency
    - `fxRate` number, required — The FX rate applied to any conversion between transaction & billing amount. Rounded to 6 decimal places and zero padded
    - `mcc` string, required — The Merchant Category Code (MCC) for the card activity. Follows ISO-18245 format
    - `merchantName` string — The merchant name
    - `merchantId` string — The merchant ID
    - `merchantCountry` string — The 3 letter ISO 3166 merchant country code
    - `acquirerReferenceNumber` string — The Acquirer Reference Number (ARN)
    - `authorisationInfo` CardAuthInfo
      - `type` string, required — Transaction type
      - `inputMethod` string, required — Input method
    - `cardTokenId` string — The card token associated with this activity, if a tokenised card was used.
    - `cardTokenDeviceId` string — The bound card token device associated with this activity, if a tokenised card was used.
  - `size` integer, required — Page size
  - `totalSize` integer, required — Total count
  - `page` integer, required — Current page number, 0 based; i.e first-page = 0, second-page = 1
  - `totalPages` integer, required — Total pages

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/modulrfinance/apis/modulr-api.md) · [All operations](https://skmtc.net/modulrfinance/apis/modulr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modulrfinance/modulr-api/versions/cbd52524c8ef/schema)