---
title: "Get pending transactions by account"
method: GET
path: "/accounts/{id}/transactions/pending"
tags: ["Transactions"]
---

# Get pending transactions by account

`GET /accounts/{id}/transactions/pending`

Get a list of the user's pending transactions for a specific connected account.

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.
- `404` — The item you are trying to access doesn't exist.
- `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)