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

# Get pending transactions

`GET /transactions/pending`

Get a list of pending transactions from a user's connected accounts.

This endpoint returns pending transactions from all of a user's accounts that the user has connected to your application.

Pending transactions are not stable (eg. the date or description may change) due to the unreliable nature of the underlying NZ bank data.

>️ ℹ️ You can tell when we last fetched a transaction by looking at it's `updated_at` key.

- All transactions timestamps are in **UTC**.

For more details see:
- [📚 Accessing transactional data guide](/docs/accessing-transactional-data)
- [📚 Pending transactions guide](/docs/accessing-transactional-data#pending-transactions)
- [📖 Transaction model](/docs/the-transaction-model)

## Headers

- `X-Akahu-Id` string, required

## Response `200`

Successful response.

- object
  - `success` boolean
  - `items` PendingTransaction[]
    - `_account` string — The Akahu Account ID that this transaction belongs to
    - `_connection` string — The Akahu Connection ID that this transaction belongs to
    - `_user` string — The Akahu User ID that this transaction belongs to
    - `updated_at` string, date-time — The ISO 8601 timestamp of when this transaction was last updated by Akahu
    - `date` string, date-time — The ISO 8601 timestamp for the transaction from the bank.
    - `description` string — The raw transaction description, essentially what you see on a bank statement
    - `amount` number — How much money this transaction was for
    - `type` 'CARD' | 'PAYMENT' | 'TRANSFER' | 'INTEREST' | 'FEE' | 'TAX' | 'DIRECT CREDIT' | 'DIRECT DEBIT' | 'STANDING ORDER' | 'ATM' | 'FX' | 'LOAN' | 'KIWISAVER' | 'CREDIT' | 'DEBIT' | 'UNKNOWN' — 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.
    - `meta` object — Additional metadata we manage to retrieve for the transaction. Only present when you have permission to view enriched transactions. All fields are optional and provided on a "best-effort" basis.
      - `particulars` string — The particulars field set on this transaction.
      - `code` string — The code field set on this transaction.
      - `reference` string — The reference field set on this transaction.
      - `other_account` string — The formatted NZ bank account number of the other party to this transaction.
      - `conversion` object — If this transaction was made in another currency, details about the currency conversion.
        - `amount` number — The amount transacted in the foreign currency
        - `currency` string — The (3 letter ISO 4217 currency code)[https://www.xe.com/iso4217.php] that was used for this transaction.
        - `rate` number — The foreign currency conversion rate applied to this transaction.
      - `card_suffix` string — If this transaction was made with a credit or debit card, the last four digits of the card number.

## 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)