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

# List of pending transactions

`GET /transactions/pending`

## Request

- Base URL: `https://www.saltedge.com/api/v5`
- URL: `https://www.saltedge.com/api/v5/transactions/pending`
- Auth: API key in header `App-id` and API key in header `Secret`
- TypeScript: <https://skmtc.dev/saltedge/apis/salt-edge-account-information-api/docs/transactions/pending/get.ts> (a function with typed inputs; its response is checked against the schema)

You can use this route to obtain the currently pending transactions for an account.

## Query parameters

- `account_id` string: the `id` of the account
- `from_id` string: the `id` of the transaction which the list starts with
- `connection_id` string, required: the `id` of the connection

## Response `200`

OK

- TransactionsResponse
  - `data` Transaction[]
    - `id` string, required: id of the transaction
    - `mode` 'normal' | 'fee' | 'transfer', required
    - `status` 'posted' | 'pending', required
    - `made_on` string, date, required: the date when the transaction was made
    - `amount` number, required: transaction's amount
    - `currency_code` string, required: transaction's currency code
    - `description` string, required: transaction's description
    - `category` string, required: transaction's category
    - `duplicated` boolean, required: whether the transaction is duplicated or not
    - `extra` TransactionExtra, required
      - `account_balance_snapshot` number: balance of the account at the moment of the attempt when the transaction was imported.
      - `account_number` string: number of the account the transaction belongs to.
      - `additional` string: additional information (recommended to use in concatenation with original description, if present).
      - `asset_amount` number: original transaction amount in asset units.
      - `asset_code` string: asset common used abbreviation (Ex.: `BTC` - Bitcoin, `XAU` - Gold etc.)
      - `categorization_confidence` number: value from `0` to `1`, the probability that the current category is the correct one.
      - `check_number` string: payee's transaction check number.
      - `closing_balance` number: account balance after the transaction was imported.
      - `constant_code` string: payment reference for cashless domestic payments (transfers).
      - `convert` boolean: whether the transaction amount was converted using exchange rates or not.
      - `customer_category_code` string: the category (present in [categories](#categories) list) that was categorized by the rules [created](#categories-learn) by the customer.
      - `customer_category_name` string: the category (not present in [categories](#categories) list) that was categorized by the rules [created](#categories-learn) by the customer.
      - `exchange_rate` object: the exchange rate that was applied to the converted transaction.
      - `id` string: transaction's identifier on the bank's end (do not confuse it with Salt Edge transaction `id`).
      - `end_to_end_id` string: a unique identifier set by the merchant. Usually used for reconciliation.
      - `information` string: information about the transaction.
      - `mcc` string: the transaction's [Merchant Category Code](http://www.irs.gov/irb/2004-31_IRB/ar17.html).
      - `merchant_id` string: merchant's identifier.
      - `opening_balance` number: account balance before the transaction was imported.
      - `original_amount` number: native amount of the transaction in transaction's currency (comes with `original_currency_code`).
      - `original_category` string: the original category of the transaction.
      - `original_currency_code` string: native currency of the transaction (comes with `original_amount`).
      - `original_subcategory` string: the original subcategory of the transaction.
      - `payee` string: to whom the money was paid.
      - `payee_information` string: additional payee information.
      - `payer` string: who paid the money.
      - `payer_information` string: additional payer information.
      - `possible_duplicate` boolean: is set to `true` if current transaction duplicates `amount`, `made_on` and `currency_code` of any transaction parsed in previous attempt.
      - `posted_by_aspsp` boolean: indicates that transaction is marked as posted (or booked) by the bank, but has the pending status assigned by Salt Edge due to `custom_pendings_period` logic.
      - `posting_date` string, date: date when the transaction appears in statement.
      - `posting_time` string: time in `HH:MM:SS` format, representing time when the transaction appears in statement.
      - `record_number` string: bank record number.
      - `specific_code` string: additional identification information for cashless domestic payments (transfers).
      - `tags` string[]: user defined information in the bank or e-wallet interface, assigned to a transaction record (not category).
      - `time` string, time: time when the transaction was made.
      - `transfer_account_name` string: name of the linked account.
      - `type` string: transaction type.
      - `unit_price` number: price per unit (used with units, available for investment accounts nature only).
      - `units` number: amount of units owned (used with unit_price, available for investment accounts nature only).
      - `variable_code` string: identifies the tax subject to the tax office, used for domestic payments (transfers).
    - `account_id` string, required: the `id` of the account the transaction belongs to
    - `created_at` string, date-time, required: time and date when the transaction was imported
    - `updated_at` string, date-time, required: the last time when the transaction's attributes (duplicated flag set, category learned applied) were changed by the client
  - `meta` MetaObject: Metaobject that contains information about pagination.
    - `next_id` string
    - `next_page` string

## Other responses

- `400`: Sending a value (e.g. `id`) which exceeds integer limit
- `404`: An account with the sent `account_id` could not be found

## Changes

> 17 revisions in range; 1 not diffed.

- **2025-03-22** `497b2a14a8e8`: 1 warning
  - removed the optional property `data/items/extra/installment_debt_amount` from the response with the `200` status
- **2023-11-29** `63d394173758`: 1 breaking, 1 info
  - the `data/items/extra/exchange_rate` response's property type changed from `number` to `object`, and format from `float` to no format for status `200`
  - added the optional property `data/items/extra/posted_by_aspsp` to the response with the `200` status
- **2023-06-10** `0f60ddc45fab`: 1 breaking
  - the `data/items/extra/exchange_rate` response's property type changed from `float` to `number`, and format from no format to `float` for status `200`
- **2021-10-24** `16de527b0cc6`: 2 info
  - added the optional property `data/items/extra/end_to_end_id` to the response with the `200` status
  - added the optional property `data/items/extra/exchange_rate` to the response with the `200` status
- **2021-07-29** `9eda9646ec8c`: 44 breaking, 8 info
  - the response property `data/items/extra/account_balance_snapshot` became nullable for the status `200`
  - the response property `data/items/extra/account_number` became nullable for the status `200`
  - the response property `data/items/extra/additional` became nullable for the status `200`
  - the response property `data/items/extra/asset_amount` became nullable for the status `200`
  - …48 more

[Operation history](https://skmtc.dev/saltedge/apis/salt-edge-account-information-api/changes/transactions/pending/get.md)

---

[API](https://skmtc.dev/saltedge/apis/salt-edge-account-information-api.md) - [All operations](https://skmtc.dev/saltedge/apis/salt-edge-account-information-api/llms.txt) - [OpenAPI document](https://skmtc.dev/saltedge/apis/salt-edge-account-information-api/revisions/acda2850de69?raw)
