---
title: "List transactions · Transactions · COUNT Partner API"
description: "Returns a paginated list of transactions, newest first. GET /partners/transactions"
canonical: "https://developers.getcount.com/reference/transactions/list-transactions"
source: "https://developers.getcount.com/reference/transactions/list-transactions"
---
[Transactions](https://developers.getcount.com/reference/transactions) / List transactions

# List transactions

GET `/partners/transactions`

Returns a paginated list of transactions, newest first.

HMAC signature + Bearer access token

[Try this request](https://developers.getcount.com/tools/try-it?method=GET&path=%2Fpartners%2Ftransactions)

[Chart of Accounts API](https://developers.getcount.com/reference/chart-of-accounts) [Bills API](https://developers.getcount.com/reference/bills) [Invoices API](https://developers.getcount.com/reference/invoices)

#### Query parameters

`page` integer optional

Page number. First page is 1.

`limit` integer optional

Records per page. Maximum 100.

`startDate` date optional

Filter on postedDate (ISO, inclusive).

`endDate` date optional

Filter on postedDate (ISO, inclusive).

`accUuid` uuid optional

Filter by bank/cash account UUID (alias: accountUuid).

`categoryAccountUuid` uuid optional

Filter by category account UUID.

`vendorUuid` uuid optional

Filter by vendor UUID.

`customerUuid` uuid optional

Filter by customer UUID.

`projectUuid` uuid optional

Filter by project UUID.

`tagUuids` string optional

Comma-separated tag UUIDs or array of UUIDs.

`transactionTypes` enum optional

Filter by type.

One of: `Expense`, `Income`, `Transfer`, `Journal Entry`

`type` enum optional

Alias for transactionTypes — use one or the other.

One of: `Expense`, `Income`, `Transfer`, `Journal Entry`

`reviewed` boolean optional

Filter by review state (true/false or "true"/"false").

`reconciled` boolean optional

Filter by reconciliation state.

`pending` boolean optional

Filter by pending state.

`excluded` boolean optional

Filter by excluded state.

`currency` string optional

ISO 4217 currency code — match the target bill or invoice currency.

`forAttachment` boolean optional

Bill/invoice picker search mode. Excludes original_amount from amount search.

`status` enum optional

Repeatable status filter tokens.

One of: `notAttachedBill`, `notAttachedInvoice`, `pending`, `excluded`, `reviewed`, `reconciled`, `completed`, `included`

`transactionLevel` enum optional

Split row mode.

One of: `split`, `splitParent`

`search` string optional

Free-text search across description and notes.

#### Responses

`200` Paginated list of transactions.

`401` Unauthorized — authentication failed. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-401)

[Next GET Get a transaction](https://developers.getcount.com/reference/transactions/get-transaction)

GET `https://api.getcount.com/partners/transactions`

Request

```javascript
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;
const ACCESS_TOKEN = process.env.COUNT_ACCESS_TOKEN;

const method = 'GET';
const signingPath = '/transactions';
const timestamp = Math.floor(Date.now() / 1000).toString();
const bodyString = '';

const bodyHash = '';
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/partners/transactions`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    Authorization: `Bearer ${ACCESS_TOKEN}`,
  },
});

console.log(await response.json());
```

Response · 200

```json
{
  "status": "success",
  "message": "Success on fetching transactions.",
  "results": 1,
  "totalRecords": 1,
  "page": 1,
  "limit": 50,
  "data": {
    "transactions": [
      {
        "id": "b7c8d9e0-f1a2-3456-bcde-678901234567",
        "type": "EXPENSE",
        "description": "Office supplies from Amazon",
        "amount": -150,
        "currency": "USD",
        "postedDate": "2026-03-01",
        "authorizedDate": "2026-03-01",
        "notes": "Q1 office supplies",
        "paymentChannel": "online",
        "reviewed": false,
        "excluded": false,
        "pending": false,
        "split": false,
        "accountId": "c8d9e0f1-a2b3-4567-cdef-789012345678",
        "categoryAccountId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "vendorId": "d4e5f6a7-b8c9-0123-defa-234567890123",
        "customerId": null,
        "billId": null,
        "invoiceId": null,
        "tags": [
          {
            "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
            "name": "Office"
          }
        ],
        "createdAt": "2026-03-13T08:30:00.000Z",
        "updatedAt": "2026-03-13T08:30:00.000Z"
      }
    ]
  }
}
```