> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equalsmoney.com/llms.txt
> Use this file to discover all available pages before exploring further.

# View all transactions

> View a list of transactions that have occurred on an account.

## List transaction activity

<Note>
  **GET** `/v2/activity/{accountId}`
</Note>

### Request

Use this request to get a list of transactions for a given account, based on its `id`. Results are ordered chronologically by creation date, with the most recent transaction appearing first.

```bash Sample request theme={null}
curl -i -X GET \
  'https://api.equalsmoney.com/v2/activity/F12345' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'
```

```bash Request structure theme={null}
curl -i -X GET \
  'https://api.equalsmoney.com/v2/activity/{accountId}' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'
```

#### Path parameters

<ParamField body="accountId" type="string" required>
  The ID of the account that you want to get a list of transactions for.

  Allowable values: An existing `accountId`
</ParamField>

#### Query parameters

<ParamField body="limit" type="integer">
  The maximum amount of results to return. By default, this is set to `100`.

  Allowable values: `[ 1 .. 1000 ]`
</ParamField>

<ParamField body="offset" type="integer">
  The amount of results to skip. By default, this is set to `0`.

  Allowable values: A valid integer
</ParamField>

<ParamField body="include" type="array of strings">
  Optional additional information to return in the results.

  Allowable values: `bankFeedDetails`, `annotations`, `attachments`
</ParamField>

<ParamField body="personId" type="array of strings (uuid)">
  The ID of the person to filter results by. Use commas to pass multiple values. Has to be URL encoded.

  Example: `personId=34edaf73-49be-4669-83ee-1b1f8c680d29%2Ceee079a2-5453-4a69-8d5d-223db353f0f3`
</ParamField>

<ParamField body="type" type="array of strings">
  The `type` to filter results by. Use commas to pass multiple values. Has to be URL encoded. For example, `type=payment%2Cload`. For more information about each type, see [About transaction types](/pages/transactions/about-transaction-types).

  Allowable values: `exchange`, `payment`, `deposit`, `forwardContract`, `drawdown`, `card`, `cardCheck`, `cardRefund`, `cashWithdrawal`, `atm`, `unload`, `otherDebit`, `load`, `cashback`, `chargeback`, `otherCredit`, `fee`, `batchPayment`
</ParamField>

<ParamField body="excludeType" type="array of strings">
  The type to exclude in the transactions list. Use commas to pass multiple values. Has to be URL encoded.

  Allowable values: `exchange`, `payment`, `deposit`, `forwardContract`, `drawdown`, `card`, `cardCheck`, `cardRefund`, `cashWithdrawal`, `atm`, `unload`, `otherDebit`, `load`, `cashback`, `chargeback`, `otherCredit`, `fee`, `batchPayment`
</ParamField>

<ParamField body="status" type="array of strings">
  The `status` to filter results by. Use commas to pass multiple values. Has to be URL encoded. For example, `status=complete%2Ccancelled`. For more information about each status, see [About transaction statuses](/pages/transactions/about-transaction-statuses).

  Allowable values: `needsApproval`, `fundsRequired`, `pending`, `complete`, `declined`, `reverted`, `refunded`, `cancelled`, `open`, `cardCheck`, `fundsSettled`
</ParamField>

<ParamField body="budgetId" type="array of strings (uuid) or null">
  The `budgetId` to filter results by. Use commas to pass multiple values. Has to be URL encoded.

  Allowable values: An existing `budgetId` (≤ 36 characters)
</ParamField>

<ParamField body="budgetName" type="array of strings (uuid) or null">
  The `budgetName` to filter results by. Use commas to pass multiple values. Has to be URL encoded. For example, `budgetName=Account%2Cmarketing`.

  Allowable values: An existing `budgetName` (≤ 36 characters)
</ParamField>

<ParamField body="sellCurrency" type="array of strings">
  Filters transactions that include selling these currencies. Use commas to pass multiple values. Has to be URL encoded. For example, `sellCurrency=usd%2Cgbp`.

  Allowable values: 3 characters
</ParamField>

<ParamField body="buyCurrency" type="array of strings">
  Filters transactions that include purchasing these currencies. Use commas to pass multiple values. Has to be URL encoded. For example, `buyCurrency=usd%2Cgbp`.

  Allowable values: 3 characters
</ParamField>

<ParamField body="startDate" type="string (date)">
  The earliest date from which to retrieve results (includes transactions on this date). For example, `startDate=2021-02-15`.

  Allowable values: Format: `YYYY-MM-DD`
</ParamField>

<ParamField body="endDate" type="string (date)">
  The latest date until which to retrieve results (includes transactions on this date). For example, `endDate=2021-03-30`.

  Allowable values: Format: `YYYY-MM-DD`
</ParamField>

<ParamField body="dateField" type="string" default="transaction.createdAt">
  Selects which date field `startDate` and `endDate` filter against. `transaction.createdAt` (the default) filters by the date the transaction was created; `transactionBox.valueDateTime` filters by the date the transaction was completed/settled. For example, `dateField=transactionBox.valueDateTime`.

  Note: under `transactionBox.valueDateTime`, transaction types that have no settlement date (currency purchases and orders) are excluded from the results.

  Allowable values: `transaction.createdAt`, `transactionBox.valueDateTime`
</ParamField>

<ParamField body="search" type="string">
  Filters results that include this string. For example, `search=Jane+Doe`.

  Allowable values: A valid string
</ParamField>

<ParamField body="annotationStatus" type="array of strings">
  If `annotations` is included in the `include` parameter, this will filter the transactions based on the status of the annotations. For example, `annotationStatus=draft%2Csubmitted`.

  Allowable values: `draft`, `submitted`, `unannotated`
</ParamField>

<ParamField body="attachmentStatus" type="array of strings">
  If `attachments` is included in the `include` parameter, this will filter the transactions based on whether transactions have attachments or not. For example, `attachmentStatus=absent%2Cpresent`

  Allowable values: `absent`, `present`, `lost`
</ParamField>

### Response

If your request is successful, you'll receive a `200` response containing a list of transactions, ordered chronologically with the most recent transaction appearing first.

<CodeGroup>
  ```json Sample response theme={null}
  {
    "count": 3,
    "limit": 100,
    "offset": 0,
    "rows": [
      {
        "budget": "companyBalance",
        "resourceType": "payment",
        "id": 123456,
        "orderId": 654321,
        "userId": "4bf13dc8-d128-4521-99b8-4002b8987499",
        "originId": "0684fc07-4abc-46de-b664-da45ef3c4072",
        "originOrderId": "F6VOXCZ1AMND",
        "companyId": "F12345",
        "status": "fundsRequired",
        "isMultiBeneficiary": false,
        "remitterName": null,
        "beneficiaryId": "7l2nks3eh",
        "beneficiaryName": "William Walker",
        "beneficiaryAddress": "",
        "beneficiaryAccountNumber": "12345678",
        "beneficiarySortCode": "123456",
        "beneficiaryIban": "",
        "beneficiaryBankCode": "",
        "beneficiaryCountryCode": "GB",
        "beneficiaryBankAddress": "UPPER THAMES STREET, 68 VINTNERS PLACE FAIRFX FLOOR 3 LONDON EC4V 3BJ",
        "beneficiaryRoutingInfo": "Payment will be routed from Bank of England and then through Lloyds bank",
        "reference": "Invoice 3468 payment",
        "amount": 99.99,
        "currency": "GBP",
        "buyCurrency": "GBP",
        "sellCurrency": "GBP",
        "settlementAmountWithoutFee": 99.99,
        "settlementAmount": 99.99,
        "settlementFee": 0,
        "customerRate": 1,
        "customerInverseRate": 1,
        "uniqueId": "8233f929-94d3-4390-8d27-da92b733cafb",
        "confirmationKey": "F12345/pdf/F12345-F6VOXCZ1AMND.pdf",
        "cardLastFour": null,
        "cardExpiry": null,
        "cardNetwork": null,
        "type": "payment",
        "budgetId": "63f4b801-70d6-4bba-b3f3-7b9acd051633",
        "budgetName": "Account balance",
        "createdAt": "2022-11-14T10:55:28.000Z",
        "updatedAt": "2022-11-14T10:55:30.000Z",
        "order": {
          "id": 123456,
          "companyId": "F12345",
          "originId": "F6VOXCZ1AMND",
          "parentOriginId": null,
          "userId": "d4fd55fe-836d-48d2-8d49-e5629bd508a6",
          "userName": "",
          "status": "fundsRequired",
          "type": "payment",
          "createdAt": "2022-11-14T10:55:28.000Z",
          "updatedAt": "2022-11-14T10:55:30.000Z",
          "events": [
            {
              "id": "beec0eb3-3e11-44a4-86de-65404510038a",
              "eventId": "4c191b59-685b-454b-bad7-e832505ee51c",
              "orderCreatedAt": "2022-11-14T10:55:28.000Z",
              "eventType": 0,
              "orderId": 123456,
              "title": "Order created",
              "description": "Payment to William Walker created"
            }
          ]
        },
        "transactionBoxes": []
      },
      {
        "resourceType": "box",
        "id": "1352a456-b53f-4930-a151-1694c5655549",
        "accountId": "F12345",
        "transactionGroupId": "ef0b2cd8-119d-4403-9cde-5d19414f05a9",
        "sourceGroupId": null,
        "transactionType": "Boxes",
        "status": null,
        "transactionDate": null,
        "createdAt": "2022-11-12T06:02:53.000Z",
        "updatedAt": "2022-11-12T06:02:53.000Z",
        "transactionGroup": {
          "id": "ef0b2cd8-119d-4403-9cde-5d19414f05a9",
          "accountId": "F12345",
          "personId": null,
          "firstName": null,
          "lastName": null,
          "budgetId": "fe64b139-4824-41b5-93c2-0fad876ceac0",
          "budgetName": "Account balance",
          "createdAt": "2022-11-12T06:02:53.000Z",
          "updatedAt": "2022-11-12T06:02:53.000Z"
        },
        "transactionBox": {
          "id": "992e9652-d313-4ea7-aa93-b96b247627c2",
          "transactionId": "1352a456-b53f-4930-a151-1694c5655549",
          "transactionBoxableId": "1352a456-b53f-4930-a151-1694c5655549",
          "boxId": null,
          "type": "credit",
          "amount": 99.99,
          "currency": "GBP",
          "paymentType": "UK.OBIE.FPS",
          "transactionReference": "02FP000000199076071020221",
          "statementReference": "Ref",
          "creditDebitIndicator": "Credit",
          "debitId": null,
          "creditId": 48731088,
          "boxTransactionId": null,
          "thirdPartyReference": "",
          "marqetaTransactionToken": null,
          "marqetaTransactionIdentifier": null,
          "internalAccountTransferId": "Test 123456",
          "affectsLedgerBalance": true,
          "runningBalance": null,
          "blockId": null,
          "blockTag": null,
          "valueDateTime": "2022-11-12T06:01:52.000Z",
          "transactionBoxableType": "transaction",
          "orderId": null,
          "eventSource": "External Credit",
          "createdAt": "2022-11-12T06:02:53.000Z",
          "updatedAt": "2022-11-12T06:02:53.000Z",
          "chargeBearer": null,
          "transactionDebtorAccount": {
            "id": "4a13687d-7543-4809-96c4-4bd1a24a006e",
            "transactionBoxId": "992e9652-d313-4ea7-aa93-b96b247627c2",
            "ownerId": null,
            "accountId": null,
            "schemeName": "UK.OBIE.SortCodeAccountNumber",
            "identification": "00999718976098",
            "name": "William Walker",
            "address": null,
            "institutionName": null,
            "institutionAddress": null,
            "institutionBic": ""
          },
          "transactionCreditorAccount": {
            "id": "97e652a1-ca0b-40ce-8926-73a2f450c974",
            "transactionBoxId": "992e9652-d313-4ea7-aa93-b96b247627c2",
            "ownerId": "3de6732e39",
            "accountId": "d767e2390c",
            "schemeName": "UK.OBIE.SortCodeAccountNumber",
            "identification": "00999734593642",
            "name": "John Smith"
          }
        }
      },
      {
        "resourceType": "card",
        "id": "19bbf64b-ddfb-48ee-b125-66ed4455d534",
        "accountId": "F12345",
        "transactionGroupId": "f863de54-1cac-49b2-b624-ffd3a54dfcc7",
        "sourceGroupId": "71013bb0-f3fa-48a9-917e-39434df17aa7",
        "transactionType": "Marqeta",
        "status": null,
        "transactionDate": "2022-08-18T13:38:01.000Z",
        "createdAt": "2022-08-17T07:07:10.000Z",
        "updatedAt": "2022-08-18T14:25:22.000Z",
        "transactionGroup": {
          "id": "f863de54-1cac-49b2-b624-ffd3a54dfcc7",
          "accountId": "F12345",
          "personId": "e5098eb4-4800-4276-a234-2a9185399430",
          "firstName": "John",
          "lastName": "Smith",
          "budgetId": "650b2c1b-21fa-4d79-b73c-7aa9482c0e66",
          "budgetName": "Account Balance",
          "createdAt": "2022-08-17T07:07:12.000Z",
          "updatedAt": "2022-08-17T07:07:12.000Z"
        },
        "cardTransaction": {
          "id": "7a5e1306-794c-4ccb-a0d1-e647eff79c6b",
          "transactionToken": null,
          "identifier": 1234,
          "transactionId": "19bbf64b-ddfb-48ee-b125-66ed4455d534",
          "localAmount": 99.99,
          "localAmountCurrency": "GBP",
          "baseCurrency": null,
          "feeAmount": 0,
          "feeCurrency": "GBP",
          "exchangeRate": 1,
          "total": 0,
          "cardName": "Debit Card",
          "cardId": "8fe9cd43-d79f-4025-a0dc-3ee4ace98eb8",
          "cardProductToken": null,
          "cardType": "PHYSICAL_MSR",
          "cardLastDigits": "1234",
          "status": "unknown",
          "type": "unknown",
          "approvalCode": 654321,
          "acquirerInstitutionIdCode": "000000",
          "acquirerReferenceNumber": null,
          "paymentChannel": null,
          "transactionCompletedAt": "2022-08-19T00:00:00.000Z",
          "transactionCreatedAt": "2022-08-17T07:07:10.000Z",
          "boxesResponse": null,
          "createdAt": "2022-08-18T14:25:22.000Z",
          "updatedAt": "2022-08-18T14:25:22.000Z",
          "chargedTotalAmount": null,
          "chargedAmount": null,
          "chargedCurrency": null,
          "response": {
            "code": null,
            "memo": null
          }
        },
        "merchant": {
          "id": "7221d41b-69c3-4fbc-8317-d3210d97b3ab",
          "merchantCategoryId": "d780ae34-dfe1-4e24-82f0-2043c7fa30d4",
          "mid": "5009545",
          "subMerchantId": null,
          "originalName": "ACME COFFEE",
          "name": "ACME COFFEE",
          "description": null,
          "address": null,
          "city": "LONDON",
          "state": "GBR",
          "postalCode": "EC3V 2BJ",
          "countryCode": "GBR",
          "website": null,
          "logo": null,
          "emoji": "",
          "notes": "",
          "createdAt": "2022-01-11T09:46:07.000Z",
          "updatedAt": "2022-01-11T09:46:07.000Z",
          "merchantCategory": {
            "id": "d780ae34-dfe1-4e24-82f0-2043c7fa30d4",
            "code": "5814",
            "description": "Fast food restaurants",
            "createdAt": "2021-09-10T08:55:06.000Z",
            "updatedAt": "2021-09-10T08:55:06.000Z"
          }
        }
      }
    ]
  }
  ```

  ```json Response structure theme={null}
  {
    "count": integer,
    "limit": integer,
    "offset": integer,
    "rows": [
      {
        "budget": "string",
        "resourceType": "string",
        "id": integer,
        "orderId": integer,
        "userId": "string",
        "originId": "string",
        "originOrderId": "string",
        "companyId": "string",
        "status": "string",
        "isMultiBeneficiary": boolean,
        "remitterName": "string",
        "beneficiaryId": "string",
        "beneficiaryName": "string",
        "beneficiaryAddress": "string",
        "beneficiaryAccountNumber": "string",
        "beneficiarySortCode": "string",
        "beneficiaryIban": "string",
        "beneficiaryBankCode": "string",
        "beneficiaryCountryCode": "string",
        "beneficiaryBankAddress": "string",
        "beneficiaryRoutingInfo": "string",
        "reference": "string",
        "amount": number,
        "currency": "string",
        "buyCurrency": "string",
        "sellCurrency": "string",
        "settlementAmountWithoutFee": number,
        "settlementAmount": number,
        "settlementFee": number,
        "customerRate": number,
        "customerInverseRate": number,
        "uniqueId": "string",
        "confirmationKey": "string",
        "cardLastFour": "string",
        "cardExpiry": "string",
        "cardNetwork": "string",
        "type": "string",
        "budgetId": "string",
        "budgetName": "string",
        "createdAt": "string",
        "updatedAt": "string",
        "order": {
          "id": integer,
          "companyId": "string",
          "originId": "string",
          "parentOriginId": null,
          "userId": "string",
          "userName": "string",
          "status": "string",
          "type": "string",
          "createdAt": "string",
          "updatedAt": "string",
          "events": [
            {
              "id": "string",
              "eventId": "string",
              "orderCreatedAt": "string",
              "eventType": number,
              "orderId": number,
              "title": "string",
              "description": "string"
            }
          ]
        },
        "transactionBoxes": []
      },
      {
        "resourceType": "string",
        "id": "string",
        "accountId": "string",
        "transactionGroupId": "string",
        "sourceGroupId": null,
        "transactionType": "string",
        "status": null,
        "transactionDate": null,
        "createdAt": "string",
        "updatedAt": "string",
        "transactionGroup": {
          "id": "string",
          "accountId": "string",
          "personId": null,
          "firstName": null,
          "lastName": null,
          "budgetId": "string",
          "budgetName": "string",
          "createdAt": "string",
          "updatedAt": "string"
        },
        "transactionBox": {
          "id": "string",
          "transactionId": "string",
          "transactionBoxableId": "string",
          "boxId": null,
          "type": "string",
          "amount": number,
          "currency": "string",
          "paymentType": "string",
          "transactionReference": "string",
          "statementReference": "string",
          "creditDebitIndicator": "string",
          "debitId": null,
          "creditId": number,
          "boxTransactionId": null,
          "thirdPartyReference": "",
          "marqetaTransactionToken": null,
          "marqetaTransactionIdentifier": null,
          "internalAccountTransferId": "string",
          "affectsLedgerBalance": true,
          "runningBalance": null,
          "blockId": null,
          "blockTag": null,
          "valueDateTime": "string",
          "transactionBoxableType": "string",
          "orderId": null,
          "eventSource": "string",
          "createdAt": "string",
          "updatedAt": "string",
          "chargeBearer": null,
          "transactionDebtorAccount": {
            "id": "string",
            "transactionBoxId": "string",
            "ownerId": null,
            "accountId": null,
            "schemeName": "string",
            "identification": "string",
            "name": "string",
            "address": null,
            "institutionName": null,
            "institutionAddress": null,
            "institutionBic": ""
          },
          "transactionCreditorAccount": {
            "id": "string",
            "transactionBoxId": "string",
            "ownerId": "string",
            "accountId": "string",
            "schemeName": "string",
            "identification": "string",
            "name": "string"
          }
        }
      },
      {
        "resourceType": "string",
        "id": "string",
        "accountId": "string",
        "transactionGroupId": "string",
        "sourceGroupId": "string",
        "transactionType": "string",
        "status": null,
        "transactionDate": "string",
        "createdAt": "string",
        "updatedAt": "string",
        "transactionGroup": {
          "id": "string",
          "accountId": "string",
          "personId": "string",
          "firstName": "string",
          "lastName": "string",
          "budgetId": "string",
          "budgetName": "string",
          "createdAt": "string",
          "updatedAt": "string"
        },
        "cardTransaction": {
          "id": "string",
          "transactionToken": null,
          "identifier": number,
          "transactionId": "string",
          "localAmount": number,
          "localAmountCurrency": "string",
          "baseCurrency": null,
          "feeAmount": number,
          "feeCurrency": "string",
          "exchangeRate": number,
          "total": number,
          "cardName": "string",
          "cardId": "string",
          "cardProductToken": null,
          "cardType": "string",
          "cardLastDigits": "1234",
          "status": "string",
          "type": "string",
          "approvalCode": number,
          "acquirerInstitutionIdCode": "string",
          "acquirerReferenceNumber": null,
          "paymentChannel": null,
          "transactionCompletedAt": "string",
          "transactionCreatedAt": "string",
          "boxesResponse": null,
          "createdAt": "string",
          "updatedAt": "string",
          "chargedTotalAmount": null,
          "chargedAmount": null,
          "chargedCurrency": null,
          "response": {
            "code": null,
            "memo": null
          }
        },
        "merchant": {
          "id": "string",
          "merchantCategoryId": "string",
          "mid": "string",
          "subMerchantId": null,
          "originalName": "string",
          "name": "string",
          "description": null,
          "address": null,
          "city": "string",
          "state": "string",
          "postalCode": "string",
          "countryCode": "string",
          "website": null,
          "logo": null,
          "emoji": "string",
          "notes": "string",
          "createdAt": "string",
          "updatedAt": "string",
          "merchantCategory": {
            "id": "string",
            "code": "string",
            "description": "string",
            "createdAt": "string",
            "updatedAt": "string"
          }
        }
      }
    ]
  }
  ```
</CodeGroup>

### Pagination

Results are paginated using the `limit` and `offset` query parameters. By default, the API returns up to 100 results starting from offset 0.

To retrieve the next page of results, increase the `offset` by the `limit` value. For example, to get the second page of 100 results, set `offset=100`. You can use the `count` field in the response to determine the total number of results available.

```bash Example: Get the second page of 50 results theme={null}
curl -i -X GET \
  'https://api.equalsmoney.com/v2/activity/F12345?limit=50&offset=50' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'
```

### Filtering examples

You can combine query parameters to narrow down results. Here are some common examples.

**Filter by transaction type:**

```bash Get only card transactions theme={null}
curl -i -X GET \
  'https://api.equalsmoney.com/v2/activity/F12345?type=card' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'
```

**Filter by date range:**

```bash Get transactions from January 2024 theme={null}
curl -i -X GET \
  'https://api.equalsmoney.com/v2/activity/F12345?startDate=2024-01-01&endDate=2024-01-31' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'
```

**Filter by status:**

```bash Get only completed transactions theme={null}
curl -i -X GET \
  'https://api.equalsmoney.com/v2/activity/F12345?status=complete' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'
```

**Combine multiple filters:**

```bash Get completed card transactions from January 2024 theme={null}
curl -i -X GET \
  'https://api.equalsmoney.com/v2/activity/F12345?type=card&status=complete&startDate=2024-01-01&endDate=2024-01-31' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'
```

For more information about this request and its response, [see the API reference](/api-reference/transaction-activity/list-all-transaction-activity).