---
title: "Get the account holder's settled feed items for the specified account, which have settlement time between the two provided timestamps"
method: GET
path: "/api/v2/feed/account/{accountUid}/settled-transactions-between"
tags: ["Transaction Feed"]
---

# Get the account holder's settled feed items for the specified account, which have settlement time between the two provided timestamps

`GET /api/v2/feed/account/{accountUid}/settled-transactions-between`

The date range between `minTransactionTimestamp` and `maxTransactionTimestamp` must not exceed 1 year. Requests exceeding this limit will return HTTP 400. For queries spanning more than 1 year, use the paginated-transactions endpoint instead.

## Path parameters

- `accountUid` string, uuid, required

## Query parameters

- `minTransactionTimestamp` string, date-time, required
- `maxTransactionTimestamp` string, date-time, required

## Response `200`

Successful operation

- FeedItems — Wrapper around multiple feed items
  - `feedItems` FeedItem[]
    - `feedItemUid` string, uuid — Unique identifier for this item
    - `categoryUid` string, uuid — The category on which the transaction happened
    - `amount` CurrencyAndAmount — Representation of money
      - `currency` string, required — ISO-4217 3 character currency code
      - `minorUnits` integer, required — Amount in the minor units of the given currency; eg pence in GBP, cents in EUR
    - `sourceAmount` CurrencyAndAmount — Representation of money
      - `currency` string, required — ISO-4217 3 character currency code
      - `minorUnits` integer, required — Amount in the minor units of the given currency; eg pence in GBP, cents in EUR
    - `direction` 'IN' | 'OUT' — Was this an inbound or outbound transaction
    - `updatedAt` string, date-time — The time the transaction was last updated at
    - `transactionTime` string, date-time — The time of the transaction
    - `settlementTime` string, date-time — The time the transaction settled
    - `retryAllocationUntilTime` string, date-time
    - `source` 'BRITISH_BUSINESS_BANK_FEES' | 'CARD_FEE_CHARGE' | 'CASH_DEPOSIT' | 'CASH_DEPOSIT_CHARGE' | 'CASH_WITHDRAWAL' | 'CASH_WITHDRAWAL_CHARGE' | 'CHAPS' | 'CHEQUE' | 'CICS_CHEQUE' | 'CURRENCY_CLOUD' | 'DIRECT_CREDIT' | 'DIRECT_DEBIT' | 'DIRECT_DEBIT_DISPUTE' | 'INTERNAL_TRANSFER' | 'MASTER_CARD' | 'MASTERCARD_MONEYSEND' | 'MASTERCARD_CHARGEBACK' | 'MISSED_PAYMENT_FEE' | 'FASTER_PAYMENTS_IN' | 'FASTER_PAYMENTS_OUT' | 'FASTER_PAYMENTS_REVERSAL' | 'STRIPE_FUNDING' | 'INTEREST_PAYMENT' | 'NOSTRO_DEPOSIT' | 'OVERDRAFT' | 'OVERDRAFT_INTEREST_WAIVED' | 'FASTER_PAYMENTS_REFUND' | 'STARLING_PAY_STRIPE' | 'ON_US_PAY_ME' | 'LOAN_PRINCIPAL_PAYMENT' | 'LOAN_REPAYMENT' | 'LOAN_OVERPAYMENT' | 'LOAN_LATE_PAYMENT' | 'LOAN_FEE_PAYMENT' | 'LOAN_INTEREST_CHARGE' | 'SEPA_CREDIT_TRANSFER' | 'SEPA_DIRECT_DEBIT' | 'TARGET2_CUSTOMER_PAYMENT' | 'FX_TRANSFER' | 'ISS_PAYMENT' | 'STARLING_PAYMENT' | 'SUBSCRIPTION_CHARGE' | 'OVERDRAFT_FEE' | 'WITHHELD_TAX' | 'ERRORS_AND_OMISSIONS' | 'INTEREST_V2_PAYMENT' — The source of a transaction
    - `sourceSubType` 'CONTACTLESS' | 'MAGNETIC_STRIP' | 'MANUAL_KEY_ENTRY' | 'CHIP_AND_PIN' | 'ONLINE' | 'ATM' | 'CREDIT_AUTH' | 'APPLE_PAY' | 'APPLE_PAY_ONLINE' | 'ANDROID_PAY' | 'ANDROID_PAY_ONLINE' | 'FITBIT_PAY' | 'GARMIN_PAY' | 'SAMSUNG_PAY' | 'CLICK_TO_PAY' | 'OTHER_WALLET' | 'CARD_SUBSCRIPTION' | 'NOT_APPLICABLE' | 'UNKNOWN' | 'DEPOSIT' | 'OVERDRAFT' | 'SETTLE_UP' | 'NEARBY' | 'TRANSFER_SAME_CURRENCY' | 'NEW_CARD' | 'NEW_CARD_OVERSEAS' — The source subtype of the transaction
    - `status` 'UPCOMING' | 'UPCOMING_CANCELLED' | 'PENDING' | 'REVERSED' | 'SETTLED' | 'DECLINED' | 'REFUNDED' | 'RETRYING' | 'ACCOUNT_CHECK' — The status of a transaction
    - `transactingApplicationUserUid` string, uuid — The application user that made the transaction
    - `counterPartyType` 'CATEGORY' | 'CHEQUE' | 'CUSTOMER' | 'PAYEE' | 'MERCHANT' | 'SENDER' | 'STARLING' | 'LOAN' — The type of counter party for a transaction
    - `counterPartyUid` string, uuid — The unique identifier for the counter party. eg for MERCHANT this will be the merchant uid, for PAYEE this will be the payee uid
    - `counterPartyName` string — The name of the counter party
    - `counterPartySubEntityUid` string, uuid — An identifier for the counter party sub entity. eg for MERCHANT this will be the merchant location uid, for PAYEE this will be the payee account uid
    - `counterPartySubEntityName` string — A name for the counter party sub entity, for PAYEE this will be the name set for the payee account
    - `counterPartySubEntityIdentifier` string — An external identifier for the sub entity, for PAYEE this will be the sort code of the account
    - `counterPartySubEntitySubIdentifier` string — An external sub identifier for the sub entity, for PAYEE this will be the account number of the account
    - `exchangeRate` number
    - `totalFees` number
    - `totalFeeAmount` CurrencyAndAmount — Representation of money
      - `currency` string, required — ISO-4217 3 character currency code
      - `minorUnits` integer, required — Amount in the minor units of the given currency; eg pence in GBP, cents in EUR
    - `reference` string — The reference for the transaction
    - `country` 'UNDEFINED' | 'AC' | 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AN' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BU' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CP' | 'CR' | 'CS' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DG' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EA' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'EU' | 'EZ' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'FX' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'IC' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NT' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SF' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SU' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TA' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TP' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UK' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XI' | 'XU' | 'XK' | 'XX' | 'YE' | 'YT' | 'YU' | 'ZA' | 'ZM' | 'ZR' | 'ZW' — The country in which the transaction took place. ISO 3166-1 alpha-2
    - `spendingCategory` 'BIKE' | 'BILLS_AND_SERVICES' | 'BUCKET_LIST' | 'CAR' | 'CASH' | 'CELEBRATION' | 'CHARITY' | 'CHILDREN' | 'CLOTHES' | 'COFFEE' | 'DEBT_REPAYMENT' | 'DIY' | 'DRINKS' | 'EATING_OUT' | 'EDUCATION' | 'EMERGENCY' | 'ENTERTAINMENT' | 'ESSENTIAL_SPEND' | 'EXPENSES' | 'FAMILY' | 'FITNESS' | 'FUEL' | 'GAMBLING' | 'GAMING' | 'GARDEN' | 'GENERAL' | 'GIFTS' | 'GROCERIES' | 'HOBBY' | 'HOLIDAYS' | 'HOME' | 'IMPULSE_BUY' | 'INCOME' | 'INSURANCE' | 'INVESTMENTS' | 'LIFESTYLE' | 'MAINTENANCE_AND_REPAIRS' | 'MEDICAL' | 'MORTGAGE' | 'NON_ESSENTIAL_SPEND' | 'PAYMENTS' | 'PERSONAL_CARE' | 'PERSONAL_TRANSFERS' | 'PETS' | 'PROJECTS' | 'RELATIONSHIPS' | 'RENT' | 'SAVING' | 'SHOPPING' | 'SUBSCRIPTIONS' | 'TAKEAWAY' | 'TAXI' | 'TRANSPORT' | 'TREATS' | 'WEDDING' | 'WELLBEING' | 'NONE' | 'REVENUE' | 'OTHER_INCOME' | 'CLIENT_REFUNDS' | 'INVENTORY' | 'STAFF' | 'TRAVEL' | 'WORKPLACE' | 'REPAIRS_AND_MAINTENANCE' | 'ADMIN' | 'MARKETING' | 'BUSINESS_ENTERTAINMENT' | 'INTEREST_PAYMENTS' | 'BANK_CHARGES' | 'OTHER' | 'FOOD_AND_DRINK' | 'EQUIPMENT' | 'PROFESSIONAL_SERVICES' | 'PHONE_AND_INTERNET' | 'VEHICLES' | 'DIRECTORS_WAGES' | 'VAT' | 'CORPORATION_TAX' | 'SELF_ASSESSMENT_TAX' | 'INVESTMENT_CAPITAL' | 'TRANSFERS' | 'LOAN_PRINCIPAL' | 'PERSONAL' | 'DIVIDENDS' | 'MONEY_OWED_FROM_CLIENTS' | 'CONSULTANCY_FEES' | 'OFFICE_AND_POSTAGE_COSTS' | 'TRAINING' | 'EMPLOYEE_BENEFITS' | 'ACCOUNTANCY_FEES' | 'IMPORT_VAT' | 'CATEGORISE_LATER' | 'SOFTWARE_AND_SUBSCRIPTIONS' | 'EXCHANGE_RATE_CHANGES' | 'EMPLOYEE_PENSIONS' | 'STAFF_TAXES' | 'SOFTWARE' | 'EQUIPMENT_HIRE' | 'CAPITAL_INTRODUCED' | 'DONATIONS' | 'PENSION_CONTRIBUTIONS' | 'PERSONAL_WITHDRAWALS' | 'CREDIT_CARD_REPAYMENTS' | 'TAX_POT_SAVINGS' | 'GRANTS' | 'REIMBURSED_EXPENSES' | 'VEHICLE_PURCHASES' | 'RENTAL_INCOME' | 'RENTAL_SERVICES' | 'RESIDENTIAL_PROPERTY_FINANCE_COSTS' | 'NON_RESIDENTIAL_PROPERTY_FINANCE_COSTS' | 'AGENT_MANAGEMENT_AND_LEGAL_FEES' | 'RENT_PAID_BY_YOU' | 'COUNCIL_TAX_PAID_BY_YOU' | 'OTHER_RATES_PAID_BY_YOU' | 'UTILITIES_PAID_BY_YOU' | 'RENTAL_INSURANCE' | 'REPLACING_DAMAGED_FURNISHINGS_AND_APPLIANCES' | 'GARDENING_CLEANING_AND_OTHER_SERVICES' | 'ADVERTISING' | 'MILEAGE_AND_OTHER_TRAVEL_COSTS' | 'OTHER_ALLOWABLE_COSTS' | 'MORTGAGE_CAPITAL_REPAYMENTS' | 'PROPERTY_UPGRADES' | 'RENTAL_REPAIRS_AND_MAINTENANCE' | 'DISPOSAL_OF_ASSETS' | 'COST_OF_SALES' | 'EMPLOYEE_AND_EMPLOYER_PENSIONS' | 'PAYE_AND_NI' | 'PENALTIES_AND_FINES' | 'COMPUTER_HARDWARE' | 'BUILDINGS' | 'FURNITURE_AND_EQUIPMENT' | 'INTANGIBLE_ASSETS' | 'MONEY_OWED_TO_THE_BUSINESS' | 'STOCK' | 'MONEY_OWED_TO_SUPPLIERS' | 'OWED_TO_PAYE_AND_NI' | 'CORPORATION_TAX_OWED' | 'DIRECTORS_LOAN' | 'MONEY_OWED_TO_OTHERS' | 'PENSION_CONTRIBUTIONS_OWED' | 'MONEY_OWED_TO_EMPLOYEES' | 'VEHICLE_AND_FUEL_COSTS' | 'INTEREST_GAINED' | 'UTILITIES' | 'EMPLOYEE_ENTERTAINING' | 'PLATFORM_FEES' | 'SHARE_CAPITAL_OUTSTANDING' | 'CAPITALISED_COSTS' | 'CHARITABLE_DONATIONS' | 'SHARE_PREMIUM' | 'MULTIPLE' — The category of a transaction
    - `userNote` string — The user-provided transaction note
    - `roundUp` AssociatedFeedRoundUp — Round up details associated with a feed item
      - `goalCategoryUid` string, uuid — Unique identifier of associated category
      - `amount` CurrencyAndAmount — Representation of money
        - `currency` string, required — ISO-4217 3 character currency code
        - `minorUnits` integer, required — Amount in the minor units of the given currency; eg pence in GBP, cents in EUR
    - `hasAttachment` boolean — Attachment present
    - `hasReceipt` boolean — Receipt present
    - `batchPaymentDetails` BatchPaymentDetails — The details of the batch payment this is part of, if it is
      - `batchPaymentUid` string, uuid — The unique identifier for the batch payment
      - `batchPaymentType` 'BULK_PAYMENT' — The type of the batch payment itself

## Other responses

- `4xx` — Client error. See [API status codes](#api-status-codes-1) for more details.
- `5xx` — Server error. See [API status codes](#api-status-codes-1) for more details.

---

[API](https://skmtc.net/starlingbank/apis/starling-bank-api.md) · [All operations](https://skmtc.net/starlingbank/apis/starling-bank-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/starlingbank/starling-bank-api/revisions/fa1a72b9ecec/schema)