---
title: "Get transactions"
method: GET
path: "/transactions"
tags: ["Transactions"]
---

# Get transactions

`GET /transactions`

Get a list of the user's transactions within the `start` and `end` time range.

This endpoint returns **settled**\* transactions for all accounts that the user has connected to your application. See [`GET /transactions/pending`](/reference/get_transactions-pending) to also query **pending** transactions.

**Some important things to know about this endpoint**:
- The data returned may vary depending on your app's permissions.
- All transactions timestamps are in **UTC**.
- If `start` and `end` are not provided, all available transactions will be returned.
- The `start` query parameter is **exclusive**.
- The `end` query parameter is **inclusive**.
- All timestamps use **millisecond** resolution (i.e. `2025-01-01T11:59:59.999Z` is the instant before `2025-01-01T12:00:00.000Z`).

**Further reading**:
- [📚 Accessing transactional data guide](/docs/accessing-transactional-data)
- [📚 Pagination guide](/docs/accessing-transactional-data#pagination)
- [📖 Transaction model](/docs/the-transaction-model)
- [📖 Transaction webhooks](/docs/reference-webhooks#transaction)

> \*Both inbound and outbound transactions relating to [payments](/docs/making-a-payment) initiated via Akahu skip the `/transactions/pending` endpoint and are immediately available at this endpoint instead. This ensures that such transactions receive a stable `_id` field to assist with reconciliation. Their availability at this endpoint does not guarantee that the bank has undertaken final processing of the transaction.

## Query parameters

- `start` string, date-time
- `end` string, date-time
- `cursor` string

## Headers

- `X-Akahu-Id` string, required

## Response `200`

Successful response.

- object
  - `success` boolean
  - `items` Transaction[]
    - `_id` string, required — The unique identifier for this transaction
    - `_account` string, required — The Account ID to identify which account this transaction belongs to
    - `_connection` string, required — The Connection ID to identify which institution this transaction was retrieved from.
    - `date` string, date-time, required — The ISO 8601 timestamp of when this transaction was lodged by the bank
    - `description` string, required — The raw transaction description, essentially what you see on a bank statement
    - `type` 'CARD' | 'PAYMENT' | 'TRANSFER' | 'INTEREST' | 'FEE' | 'TAX' | 'DIRECT CREDIT' | 'DIRECT DEBIT' | 'STANDING ORDER' | 'ATM' | 'FX' | 'LOAN' | 'KIWISAVER' | 'CREDIT' | 'DEBIT' | 'UNKNOWN', required — The type of transaction: - `CARD` The transaction was initiated via Credit, Debit, or EFTPOS card. - `PAYMENT` An outbound payment to another New Zealand bank account. - `TRANSFER` A money transfer between two of the user's accounts with this provider. - `INTEREST` Interest received from a savings or investment account. - `FEE` Fee paid to the institution e.g. an account fee, card fee, ATM fee. - `TAX` Tax paid on interest or other source of income. - `DIRECT CREDIT` Payment received from another party. - `DIRECT DEBIT` Direct debit payment initiated by (and paid to) a third party with prior authorization from the account holder. - `STANDING ORDER` A regular scheduled payment, aka. 'Automatic payment'. - `ATM` ATM deposit or withdrawal. - `FX` Foreign currency exchange. - `LOAN` Payments towards a loan. - `KIWISAVER` Transactions towards a KiwiSaver account. - `CREDIT` A fallback for any other money that has entered the account. - `DEBIT` A fallback for any other money that has left the account. - `UNKNOWN` An unknown transaction type.
    - `amount` number, required — The amount of money being debited or credited by this transaction. A negative value represents a debit and positive value a credit.
    - `balance` number, nullable — The account balance after the receipt of this transaction, where available
    - `meta` object — Additional metadata that Akahu has extracted from the transaction. Availability of this metadata varies greatly depending on the institution that the transaction was sourced from and the transaction type. Please note that **all metadata items are optional**.
      - `conversion` object — Currency conversion information for payments that have been converted to a foreign currency. All fields are optional except `currency`.
        - `currency` string — The 3 digit currency code identifying the foreign currency involved in the conversion.
        - `amount` number — The amount of foreign currency involved in this transaction.
        - `rate` number — The currency conversion rate.
        - `fee` number — The amount of any currency conversion fee associated with the transaction.
      - `card` string — Partial card number associated with this transaction. This is generally the last 4 digits and may relate to a debit, credit, or EFTPOS card.
      - `other_account` string — If the transaction involves money transfer to/from another New Zealand bank account, this field may contain the account number associated with the other account. Transactions that may have this data available include: `PAYMENT`, `TRANSFER`, `STANDING ORDER`, `DIRECT DEBIT`, `DIRECT CREDIT`.
    - `enrichment` object
      - `category` object, required — The base NZFCC category that the transaction belongs to. Also included is a map of less specific category groupings that this NZFCC category is part of (by default Akahu will include `personal_finance`). Custom category groupings can be configured for your application if required.
        - `_id` string, required — The NZFCC Category ID
        - `name` string, required — The NZFCC Category Name
        - `components` object[]
          - `name` string — The category name
          - `type` string — The category set that this category comes from
        - `groups` object, required — Higher level groupings that this category belongs to.
      - `merchant` object — The merchant that the transaction is paying to.
        - `_id` string, required — The Akahu Merchant ID
        - `name` string, required — The merchant name
        - `logo` string, url — URL of a .png image of the merchant logo. If no logo is available, a placeholder image is provided.
        - `website` string, uri — The Akahu Merchant website
      - `confidence` number, required — A score between `0` and `0.99` indicating Akahu's confidence in the enrichment accuracy. Currently the lowest returned confidence score is `0.5`. We are still tweaking the maths behind this score, but intend to release guidelines for usage once it becomes stable.
  - `cursor` object
    - `next` string — The cursor to get the next results

## Other responses

- `400` — Your request was malformed or otherwise unacceptable. More details are provided under the `message` key in the response.
- `401` — You are not authorised to access this content.
- `403` — You are not allowed to access this content.
- `500` — An internal error has prevented us from processing the request. More detail may be supplied in the `message` key.

---

[API](https://skmtc.net/akahu/apis/akahu-enduring-api.md) · [All operations](https://skmtc.net/akahu/apis/akahu-enduring-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/akahu/akahu-enduring-api/versions/b2de9915920d/schema)