---
title: "List earn lending actions"
method: GET
path: "/earn/actions"
tags: ["Earn"]
---

# List earn lending actions

`GET /earn/actions`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/earn/actions`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/earn/actions/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of lending actions (deposits and withdrawals) for the authenticated tenant.

## Query parameters

- `pageCursor` string
- `pageSize` integer
- `sortBy` 'createdAt' | 'updatedAt'
- `order` 'ASC' | 'DESC'

## Response `200`

OK

- GetActionsResponse
  - `data` GetActionResponse[], required: Page of lending actions for this query.
    - `id` string, required: Action sequence id (UUID).
    - `vaultAccountId` string, required: Fireblocks vault account that executed the action.
    - `userId` string, required: User who initiated the action.
    - `status` string, required: Intent status (e.g. CREATED, IN_PROGRESS, COMPLETED).
    - `providerId` 'MORPHO' | 'AAVE', required: Lending protocol identifier.
    - `actionType` 'DEPOSIT' | 'WITHDRAW', required: Whether this action is a deposit or withdraw flow.
    - `opportunityId` string, required: Target lending opportunity identifier.
    - `positionId` string: Position id in the system when applicable.
    - `amount` string, required: Human-readable amount for the action.
    - `createdAt` string, required: Creation time (ISO-8601).
    - `updatedAt` string, required: Last update time (ISO-8601).
    - `records` ActionRecord[], required: Ordered execution steps for this action.
      - `actionType` 'APPROVE' | 'DEPOSIT' | 'WITHDRAW', required: Kind of step in the lending sequence.
      - `status` 'NOT_STARTED' | 'PROCESSING' | 'PENDING_SIGNATURE' | 'BROADCASTING' | 'CONFIRMING' | 'COMPLETED' | 'FAILED' | 'CANCELED', required: Step lifecycle status.
      - `txId` string: Fireblocks transaction id when applicable (unset when NOT_STARTED).
      - `txHash` string: On-chain transaction hash when applicable (unset when NOT_STARTED).
      - `errorMessage` string: Error detail when the step failed.
      - `updatedAt` string, required: Last update time (ISO-8601); may be empty when status is NOT_STARTED.
  - `next` string: Opaque cursor for the next page; empty when there is no next page.
  - `prev` string: Opaque cursor for the previous page; empty when there is no previous page.
  - `total` integer, required: Total number of items matching the query.

## Other responses

- `403`: Forbidden: insufficient permissions, disabled feature, or restricted access.
- `404`: Not found: requested resource does not exist.
- `429`: Rate limit exceeded: slow down and retry later.
- `500`: Internal error while processing the request.
- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)