---
title: "Retrieve Account Activities"
method: GET
path: "/v1/accounts/activities"
tags: ["Accounts"]
---

# Retrieve Account Activities

`GET /v1/accounts/activities`

Returns a list of activities

Notes:
* Pagination is handled using the `page_token` and `page_size` parameters.
* `page_token` represents the ID of the last item on your current page of results.
   For example, if the ID of the last activity in your first response is `20220203000000000::045b3b8d-c566-4bef-b741-2bf598dd6ae7`, you would pass that value as `page_token` to retrieve the next page of results.

* If specified with a `direction` of `desc`, for example, the results will end before the activity with the specified ID.
* If specified with a `direction` of `asc`, results will begin with the activity immediately after the one specified.
* `page_size` is the maximum number of entries to return in the response.
* If `date` is not specified, the default and maximum value is 100.
* If `date` is specified, the default behavior is to return all results, and there is no maximum page size.

## Query parameters

- `account_id` string, uuid
- `activity_types` ActivityType[]
- `category` 'trade_activity' | 'non_trade_activity'
- `date` string, date-time
- `until` string, date-time
- `after` string, date-time
- `direction` 'asc' | 'desc'
- `page_size` integer
- `page_token` string

## Response `200`

Success

- Activity[]
  - union
    - object — Base for activity types
      - `account_id` string, uuid
      - `activity_type` 'FILL' | 'ACATC' | 'ACATS' | 'CGD' | 'CIL' | 'CSD' | 'CSW' | 'DIV' | 'DIVCGL' | 'DIVCGS' | 'DIVNRA' | 'DIVROC' | 'DIVTXEX' | 'FEE' | 'INT' | 'JNLC' | 'JNLS' | 'MA' | 'OPASN' | 'OPCA' | 'OPCSH' | 'OPEXC' | 'OPEXP' | 'OPTRD' | 'PTC' | 'REORG' | 'SPIN' | 'SPLIT' | 'FOPT', required — Represents the various kinds of activity. TradeActivity's will always have the type `FILL` - **FILL** Order Fills (Partial/Full) - **ACATC** ACATS IN/OUT (Cash) - **ACATS** ACATS IN/OUT (Securities) - **CGD** Capital Gain Distribution - **CIL** Cash in Lieu of Stock - **CSD** Cash Disbursement (+) - **CSW** Cash Withdrawable - **DIV** Dividend - **DIVCGL** Dividend (Capital Gain Long Term) - **DIVCGS** Dividend (Capital Gain Short Term) - **DIVNRA** Dividend Adjusted (NRA Withheld) - **DIVROC** Dividend Return of Capital - **DIVTXEX** Dividend (Tax Exempt) - **FEE** REG and TAF Fees - **INT** Interest (Credit/Margin) - **JNLC** Journal Entry (Cash) - **JNLS** Journal Entry (Stock) - **OPASN** Option Assignment - **OPCA** Option Corporate Action - **OPCSH** Option cash deliverable for non-standard contracts - **OPEXC** Option Exercise - **OPEXP** Option Expiration - **OPTRD** Option Trade - **MA** Merger/Acquisition - **PTC** Pass Thru Change - **REORG** Reorg CA - **SPIN** Stock Spinoff - **SPLIT** Stock Split - **FOPT** Free of Payment Transfers
      - `id` string, required
      - `cum_qty` string, decimal — Valid only for trading activity types. Null for non-trading activites.
      - `leaves_qty` string, decimal — Valid only for trading activity types. Null for non-trading activites.
      - `order_id` string, uuid — Valid only for trading activity types. Null for non-trading activites.
      - `order_status` 'new' | 'partially_filled' | 'filled' | 'done_for_day' | 'canceled' | 'expired' | 'replaced' | 'pending_cancel' | 'pending_replace' | 'accepted' | 'pending_new' | 'accepted_for_bidding' | 'stopped' | 'rejected' | 'suspended' | 'calculated'
      - `price` string, decimal — Valid only for trading activity types. Null for non-trading activites.
      - `qty` string, decimal — Valid only for trading activity types. Null for non-trading activites.
      - `side` 'buy' | 'sell' | 'buy_minus' | 'sell_plus' | 'sell_short' | 'sell_short_exempt' | 'undisclosed' | 'cross' | 'cross_short' — Represents what side of the transaction an order was on. Required for all order classes except for `mleg`.
      - `symbol` string — Valid only for trading activity types. Null for non-trading activites.
      - `transaction_time` string, date-time — Valid only for trading activity types. Null for non-trading activites.
      - `type` 'fill' | 'partial_fill' — Valid only for trading activity types. Null for non-trading activites.
    - object — Base for activity types
      - `account_id` string, uuid
      - `activity_type` 'FILL' | 'ACATC' | 'ACATS' | 'CGD' | 'CIL' | 'CSD' | 'CSW' | 'DIV' | 'DIVCGL' | 'DIVCGS' | 'DIVNRA' | 'DIVROC' | 'DIVTXEX' | 'FEE' | 'INT' | 'JNLC' | 'JNLS' | 'MA' | 'OPASN' | 'OPCA' | 'OPCSH' | 'OPEXC' | 'OPEXP' | 'OPTRD' | 'PTC' | 'REORG' | 'SPIN' | 'SPLIT' | 'FOPT', required — Represents the various kinds of activity. TradeActivity's will always have the type `FILL` - **FILL** Order Fills (Partial/Full) - **ACATC** ACATS IN/OUT (Cash) - **ACATS** ACATS IN/OUT (Securities) - **CGD** Capital Gain Distribution - **CIL** Cash in Lieu of Stock - **CSD** Cash Disbursement (+) - **CSW** Cash Withdrawable - **DIV** Dividend - **DIVCGL** Dividend (Capital Gain Long Term) - **DIVCGS** Dividend (Capital Gain Short Term) - **DIVNRA** Dividend Adjusted (NRA Withheld) - **DIVROC** Dividend Return of Capital - **DIVTXEX** Dividend (Tax Exempt) - **FEE** REG and TAF Fees - **INT** Interest (Credit/Margin) - **JNLC** Journal Entry (Cash) - **JNLS** Journal Entry (Stock) - **OPASN** Option Assignment - **OPCA** Option Corporate Action - **OPCSH** Option cash deliverable for non-standard contracts - **OPEXC** Option Exercise - **OPEXP** Option Expiration - **OPTRD** Option Trade - **MA** Merger/Acquisition - **PTC** Pass Thru Change - **REORG** Reorg CA - **SPIN** Stock Spinoff - **SPLIT** Stock Split - **FOPT** Free of Payment Transfers
      - `id` string, required
      - `activity_sub_type` string — Represents a more specific classification to the `activity_type`. This field is optional and may not always be populated, depending on the activity type and the available data. Each `activity_type` has a set of valid `activity_sub_type` values. Full mapping of `activity_type` to `activity_sub_type`: - **DIV**: Dividend activity sub-types: - **CDIV**: Cash Dividend - **SDIV**: Stock Dividend - **SPD**: Substitute Payment In Lieu Of Dividend - **FEE**: Fee-related activity sub-types: - **REG**: Regulatory Fee - **TAF**: Trading Activity Fee - **LCT**: Local Currency Trading Fee - **ORF**: Options Regulatory Fee - **OCC**: Options Clearing Corporation Fee - **NRC**: Non-Retail Commission Fee - **NRV**: Non-Retail Venue Fee - **COM**: Commission - **CAT**: Consolidated Audit Trail Fee - **INT**: Interest-related activity sub-types: - **MGN**: Margin Interest - **CDT**: Credit Interest - **SWP**: Sweep Interest - **QII**: Qualified Interest - **MA**: Merger and Acquisition activity sub-types: - **CMA**: Cash Merger - **SMA**: Stock Merger - **SCMA**: Stock & Cash Merger - **NC**: Name Change activity sub types - **SNC**: Symbol Name Change - **CNC**: CUSIP Name Change - **SCNC**: Symbol & CUSIP Name Change - **OPCA**: Option Corporate Action activity sub-types: - **DIV.CDIV**: Cash Dividend - **DIV.SDIV**: Stock Dividend - **MA.CMA**: Cash Merger - **MA.SMA**: Stock Merger - **MA.SCMA**: Stock & Cash Merger - **NC.CNC**: CUSIP Name Change - **NC.SNC**: Symbol Name Change - **NC.SCNC**: Symbol & CUSIP Name Change - **SPIN**: Spin-off - **SPLIT.FSPLIT**: Forward Stock Split - **SPLIT.RSPLIT**: Reverse Stock Split - **SPLIT.USPLIT**: Unit Split - **REORG**: Reorganization activity sub-types: - **WRM**: Worthless Removal - **SPLIT**: Stock Split activity sub-types: - **FSPLIT**: Forward Stock Split - **RSPLIT**: Reverse Stock Split - **USPLIT**: Unit Split - **VOF**: Voluntary Offering activity sub-types: - **VTND**: Tender Offer - **VWRT**: Warrant Exercise - **VRGT**: Rights Offer - **VEXH**: Exchange Offer - **WH**: Withholding activity sub-types: - **SWH**: State Withholding - **FWH**: Federal Withholding - **SLWH**: Sales Withholding
      - `created_at` string, date-time — Valid only for non-trading activity types. Null for trading activites.
      - `currency` string — Currency denomination of the activity. USD by default.
      - `cusip` string — Valid only for non-trading activity types. Null for trading activites.
      - `date` string, date — Valid only for non-trading activity types. Null for trading activites.
      - `description` string — Valid only for non-trading activity types. Null for trading activites.
      - `group_id` string, uuid — ID used to link activities who share a sibling relationship
      - `net_amount` string, decimal — Valid only for non-trading activity types. Null for trading activites.
      - `per_share_amount` string, decimal — Valid only for non-trading activity types. Null for trading activites.
      - `qty` string, decimal — Valid only for non-trading activity types. Null for trading activites.
      - `status` 'executed' | 'correct' | 'canceled' — Valid only for non-trading activity types. Null for trading activites.
      - `symbol` string — Valid only for non-trading activity types. Null for trading activites.

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)