---
title: "List Transactions"
method: GET
path: "/v2.0/transactions"
tags: ["Transactions V2"]
---

# List Transactions

`GET /v2.0/transactions`

Search and list transactions with pagination and optional keyword filter.

## Query parameters

- `pageSize` integer
- `pageNum` integer
- `queryKey` string
- `leadId` integer
- `transactionType` 'Purchase' | 'Listing' | 'Lease' | 'Other' | 'All'

## Headers

- `Authorization` string, required

## Response `200`

Successful operation

- TransactionV2PageResponse — Paginated response for transaction search.
  - `pageNum` integer — Page number (0-based).
  - `pageSize` integer — Page size.
  - `totalCount` integer — Total number of matching transactions.
  - `pageData` TransactionV2Item[]
    - `created` integer — Transaction creation timestamp, in milliseconds since Unix epoch (UTC).
    - `updated` integer — Transaction last-modified timestamp, in milliseconds since Unix epoch (UTC).
    - `transactionId` integer — Transaction ID.
    - `leadId` integer — ID of the lead this transaction belongs to.
    - `propertyId` integer — ID of the property linked to this transaction.
    - `transactionName` string — Property address or deal name.
    - `leadName` string — Name of the lead this transaction belongs to.
    - `agentName` string — Name of the agent assigned to this transaction.
    - `assignedAgent` integer — User ID of the agent this transaction is assigned to.
    - `transactionType` 'Purchase' | 'Listing' | 'Lease' | 'Other' — Transaction type. One of Purchase / Listing / Lease / Other.
    - `transactionStatus` string — Transaction status name as configured in the team's pipeline.
    - `homePrice` number — Home price of the transaction.
    - `expectedCloseDate` integer — Expected close date, in milliseconds since Unix epoch (UTC).
    - `closeDate` integer — Actual close date, in milliseconds since Unix epoch (UTC).
    - `commissionRate` number — Commission rate, expressed as a percentage (e.g. 3 for 3%).
    - `gci` number — Gross Commission Income (GCI) of the transaction.
    - `teamRevenue` number — Portion of the GCI attributed to the team.
    - `agentRevenue` number — Portion of the GCI attributed to the agent.
    - `appointmentDate` integer — Appointment date, in milliseconds since Unix epoch (UTC).
    - `agreementSignedDate` integer — Agreement-signed date, in milliseconds since Unix epoch (UTC).
    - `offerDate` integer — Offer date, in milliseconds since Unix epoch (UTC).
    - `contractDate` integer — Contract date, in milliseconds since Unix epoch (UTC).
    - `appraisalDate` integer — Appraisal date, in milliseconds since Unix epoch (UTC).
    - `homeInspectionDate` integer — Home-inspection date, in milliseconds since Unix epoch (UTC).
    - `escrowDate` integer — Escrow date, in milliseconds since Unix epoch (UTC).
    - `expiration` integer — Expiration date (listing / contract), in milliseconds since Unix epoch (UTC).
    - `customFields` CustomFieldRequest[] — Custom field values associated with the transaction.
      - `id` integer — Custom field id
      - `value` string — Custom field value For multi_select, the format is:["Item1","Item2", ...]

## Other responses

- `400` — pageNum < 0 or unrecognized transactionType (20012 INVALID_PARAMETER), or pageSize out of range (20042 LIMIT_NOT_VALID).
- `401` — Missing or invalid authentication token.
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)