--- updatedAt: 2026-01-21T13:21:21.000Z agentTools: projectIndex: https://docs.neonomics.io/llms.txt --- # /ics/v3/accounts/{id}/transactions-page **Deprecated:** This API is the same as `/transactions` and is now deprecated. This will be decommissioned by the end of Dec 2025. Please use `/transactions` instead. Returns a list of transactions for the account Id given as endpoint parameter. The account Id must first be retrieved in a Get Accounts call. This API will return a 1426 error if consent is required to access the account. **API Usage Restrictions (PSD2 Compliance):** - Each unique API call is limited to 4 requests per 24 hours per session. - **Important:** Pagination does NOT count against the same limit. Each unique cursor value has its own separate 4-call counter. # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Welcome to Open API", "description": "Discover APIs that enable you to create great user experiences and start integrating with our Payments and Accounts APIs.\nTo start with our APIs first create a Neonomics application on the [developer portal](https://developer.neonomics.io/login) to get a Neonomics application Client ID and Secret ID. Links for developer portal are mentioned below.\nAuthenticate with the Neonomics API, to obtain an access_token so Neonomics can allow you to make requests to the Neonomics API. Use Authorization API to Get\naccess token which will be used in all APIs.\n\nReference Links :\n\n[Neonomics API Documentation](https://docs.neonomics.io/documentation/development/quickstart)\n\n[Sandbox Developer Portal](https://developer.neonomics.io/login)\n\n[Production Developer Portal](https://portal.neonomics.io)\n", "version": "3.0" }, "servers": [ { "url": "https://sandbox.neonomics.io", "description": "Test env which connects banks Sandbox env" }, { "url": "https://api.neonomics.io", "description": "Production env which connects live banks" } ], "paths": { "/ics/v3/accounts/{id}/transactions-page": { "get": { "tags": [ "Accounts" ], "deprecated": true, "description": "**Deprecated:** This API is the same as `/transactions` and is now deprecated. This will be decommissioned by the end of Dec 2025. Please use `/transactions` instead.\n\nReturns a list of transactions for the account Id given as endpoint parameter. The account Id must first be retrieved in a Get Accounts call.\nThis API will return a 1426 error if consent is required to access the account.\n\n**API Usage Restrictions (PSD2 Compliance):**\n- Each unique API call is limited to 4 requests per 24 hours per session.\n- **Important:** Pagination does NOT count against the same limit. Each unique cursor value has its own separate 4-call counter.\n", "operationId": "getPaginatedTransactionsByAccountId", "parameters": [ { "$ref": "#/components/parameters/Authorization" }, { "$ref": "#/components/parameters/x-session-id" }, { "$ref": "#/components/parameters/x-device-id" }, { "$ref": "#/components/parameters/x-psu-ip-address" }, { "$ref": "#/components/parameters/x-psu-id" }, { "$ref": "#/components/parameters/x-psu-corporate-id" }, { "$ref": "#/components/parameters/x-originating-host" }, { "$ref": "#/components/parameters/x-originating-date" }, { "$ref": "#/components/parameters/Signature" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fromDate", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Furthest date in the past of requested transaction range. YYYY-MM-DD" }, { "name": "toDate", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Most recent date of requested transaction range. YYYY-MM-DD" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Link to next page of transactions. Please do not pass `fromDate` and `toDate` in query parameter\nwhen passing `cursor` parameter\n" }, { "name": "bookingStatus", "in": "query", "required": false, "schema": { "type": "string" }, "description": "“booked” or “pending”. By default all transactions are returned." }, { "name": "scope", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Provide scope for your request, possible values - (`accounts`, `business-accounts`).\nUse `accounts` (default) for retail accounts.\nUse `business-accounts` for business and corporate accounts.\n" }, { "$ref": "#/components/parameters/consent-duration" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PagedTransaction" } } } }, "510": { "$ref": "#/components/responses/510" }, "520": { "$ref": "#/components/responses/520" }, "530": { "$ref": "#/components/responses/530" } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" } }, "parameters": { "consent-duration": { "name": "consent-duration", "in": "query", "description": "The duration of the consent in minutes.", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 259200 } }, "x-device-id": { "name": "x-device-id", "required": true, "in": "header", "description": "String that uniquely identifies a single end-user or device.", "schema": { "type": "string" } }, "Authorization": { "name": "Authorization", "in": "header", "required": false, "description": "Authentication scheme used to transmit the access token. Valid value is \"Bearer {access token}\".", "schema": { "type": "string" } }, "x-originating-host": { "name": "x-originating-host", "in": "header", "required": false, "description": "The host where the request is originating from.\nIf you are using end to end encryption from our developer portal then this header is mandatory.\n", "schema": { "type": "string" } }, "x-originating-date": { "name": "x-originating-date", "in": "header", "required": false, "description": "The request originating date.\nIf you are using end to end encryption from our developer portal then this header is mandatory.\n", "schema": { "type": "string" } }, "Signature": { "name": "Signature", "in": "header", "required": false, "description": "The signature header consisting of the signature string\nIf you are using end to end encryption from our developer portal then this header is mandatory.\n", "schema": { "type": "string" } }, "x-session-id": { "name": "x-session-id", "in": "header", "required": true, "description": "The session Id returned in the response body when this session was created.", "schema": { "type": "string" } }, "x-psu-ip-address": { "name": "x-psu-ip-address", "in": "header", "required": true, "description": "The IP Address of the end-user (PSU), which must be provided if the PSU actively requests information.\nIf this value is not provided, then the call will count towards the number of TPP calls without PSU interaction.\nLeave it empty if the end user is not actively requesting account information, such as during automatic background updates.\nProvided in either IPv4 or IPv6 format.\n", "schema": { "type": "string" } }, "x-psu-id": { "name": "x-psu-id", "in": "header", "required": false, "description": "Identifier of the end-user, passed as the base64-encoded value of an encrypted string following\nthe guidelines given in Documentation > Development > Sensitive end-user data.\nThis parameter is required if the value of 'personalIdentificationRequired' returned from the /banks endpoint is \"true\".\n", "schema": { "type": "string" } }, "x-psu-corporate-id": { "name": "x-psu-corporate-id", "in": "header", "required": false, "description": "Corporate identifier of the end-user's organisation, used for business/corporate consents (the `business-accounts` scope).\n\n**Currently effective for Länsförsäkringar and Sparebanken Vest (Folio, bank `folio.noSPAVNOBB`).**\n\n- **Länsförsäkringar**: required in addition to `x-psu-id`, and both are distinct. `x-psu-id` carries the\n signing person's personnummer (SSN), type `SSSN`; `x-psu-corporate-id` carries the organisationsnummer\n (org number), type `SON`. Confirmed with the bank: both values must be **exactly 12 numeric digits** — a\n continuous digit string with no hyphens, spaces, letters, or special characters (e.g. `12345678-0987` is\n not valid). Fewer or more than 12 digits fails validation.\n- **Sparebanken Vest / Folio**: required on both consent initiation and every subsequent account/transaction\n read, not only at consent time. Carries the 9-digit Norwegian organisation number. `x-psu-id` is optional\n here and, if sent, must be the authorising person's national identifier — never the organisation number.\n\nFor all other banks this header is **currently ignored**, even those whose corporate flows rely on a corporate\nidentifier (e.g. DNB) — those flows continue to work via `x-psu-id` as today. Do not rely on this header for any\nbank other than the ones listed above; support for additional banks may be added later.\n\nIgnored for personal-scope consents.\n", "schema": { "type": "string" } } }, "schemas": { "PaginationLink": { "type": "object", "description": "Pagination link for navigating through transaction pages.", "properties": { "type": { "type": "string", "description": "HTTP method type (e.g., \"GET\")." }, "rel": { "type": "string", "description": "Link relation type. Value is \"next\" when more pages are available." }, "href": { "type": "string", "description": "The full URL containing the cursor parameter for fetching the next page." } } }, "Transaction": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique identifier for a transaction. If the field is empty, it was not provided by the bank." }, "transactionReference": { "type": "string", "description": "Transaction reference from the bank. If the field is empty, it was not provided by the bank." }, "transactionAmount": { "description": "Amount for a transaction.", "$ref": "#/components/schemas/TransactionAmount" }, "creditDebitIndicator": { "type": "string", "description": "Debit or credit code following ISO 20022. Values: \"CRDT\" (credit transaction) or \"DBIT\" (debit transaction).\n", "enum": [ "CRDT", "DBIT" ] }, "bookingDate": { "type": "string", "description": "Timestamp showing when the transaction was booked on the account, formatted following ISO8601.\nIf the timestamp has a NULL value, it signifies that the transaction represents a pending payment.\n", "format": "date-time" }, "valueDate": { "type": "string", "description": "Timestamp showing when the amount became available to the account owner (credit) or ceased to be available to the account owner (debit), formatted following ISO8601.", "format": "date-time" }, "counterpartyName": { "description": "The name of the other party that participated in the transaction. If the field is empty, it was not provided by the bank.", "type": "string" }, "counterpartyAgent": { "type": "string", "description": "8 or 11-character long BIC code of agent/intermediary bank. If the field is empty, it was not provided by the bank." }, "counterpartyAccount": { "description": "The account number of the other party that participated in the transaction. If the field is empty, it was not provided by the bank.", "type": "string" }, "currencyExchange": { "type": "object", "description": "Details of currency conversion applied to the transaction. Only present when the transaction involved a currency conversion.", "properties": { "sourceCurrency": { "type": "string", "description": "Currency of the original transaction following ISO 4217." }, "targetCurrency": { "type": "string", "description": "Currency after conversion, typically the account currency, following ISO 4217." }, "unitCurrency": { "type": "string", "description": "Currency in which the exchange rate is expressed (e.g. in \"1 GBP = X EUR\", GBP is the unit currency), following ISO 4217." }, "quotationDate": { "type": "string", "format": "date", "description": "Date the exchange rate was quoted, formatted following ISO8601." }, "sourceCurrencyAmount": { "type": "string", "description": "Transaction amount in the source currency." }, "exchangeRate": { "type": "string", "description": "Rate used to convert source currency to target currency." } } }, "referenceNumber": { "type": "string", "description": "KID or OCR number — Remittance Information Structured. If empty, it was not provided by the bank." }, "remittanceInformationUnstructuredArray": { "type": "array", "description": "Free-form remittance information as provided by the originating party.", "items": { "type": "string" } }, "merchantCategoryCode": { "type": "string", "description": "4-digit Merchant Category Code (MCC) identifying the type of business. If empty, it was not provided by the bank." }, "merchantName": { "type": "string", "description": "Merchant name as returned by the bank. If empty, it was not provided by the bank." }, "status": { "type": "string", "description": "Status of the transaction.", "enum": [ "BOOKED", "PENDING", "CANCELLED", "BILLED", "UNAVAILABLE" ] }, "proprietaryBankTransactionCode": { "type": "string", "description": "Bank-specific transaction code. If empty, it was not provided by the bank." }, "transactionType": { "type": "string", "description": "Transaction type metadata as provided by the bank." }, "typeDescription": { "type": "string", "description": "Human-readable description of the transaction type as provided by the bank." }, "bankResponse": { "type": "string", "description": "Raw bank response metadata associated with the transaction." }, "bankTransactionCode": { "type": "string", "description": "ISO 20022 bank transaction code (e.g. PMNT-RCDT-ESCT)." }, "mandateId": { "type": "string", "description": "Mandate identifier for direct debit or standing order transactions." }, "cardTransactionTypeCode": { "type": "string", "description": "Card transaction type code as provided by the bank." }, "cardTransactionDetails": { "type": "object", "description": "Detailed card transaction information. Only populated for card transactions; all fields are optional and depend on what the bank makes available.", "properties": { "cardAcceptorAddress": { "$ref": "#/components/schemas/CardAcceptorAddress" }, "cardEntryMode": { "type": "string", "description": "How the card was entered (e.g. chip, swipe, contactless, manual)." }, "posEntryMode": { "type": "string", "description": "Point-of-sale entry mode at the terminal." }, "posEnvironment": { "type": "string", "description": "Point-of-sale environment (e.g. attended, unattended, e-commerce)." }, "terminalType": { "type": "string", "description": "Type of terminal used for the transaction." }, "authenticationMethod": { "type": "string", "description": "Authentication method used (e.g. PIN, signature, biometric)." }, "scaOutcome": { "type": "string", "description": "Outcome of strong customer authentication." }, "cardholderVerificationMethod": { "type": "string", "description": "Method used to verify the cardholder." }, "credentialOnFile": { "type": "boolean", "description": "Whether the card credentials are stored on file by the merchant." }, "initiationType": { "type": "string", "description": "How the transaction was initiated (e.g. cardholder, merchant)." }, "acquirerCountryCode": { "type": "string", "description": "ISO 3166-1 alpha-2 country code of the acquiring bank." }, "crossBorderIndicator": { "type": "boolean", "description": "Whether the transaction crossed country borders." } } } } }, "CardAcceptorAddress": { "type": "object", "description": "Postal address of the card acceptor (merchant).", "properties": { "streetName": { "type": "string", "description": "Street name of the merchant." }, "buildingNumber": { "type": "string", "description": "Building number of the merchant." }, "postCode": { "type": "string", "description": "Post code of the merchant." }, "townName": { "type": "string", "description": "Town or city name of the merchant." }, "countrySubDivision": { "type": "string", "description": "State or province of the merchant." }, "country": { "type": "string", "description": "ISO 3166-1 alpha-2 country code of the merchant." }, "unstructured": { "type": "string", "description": "Unstructured address line when structured components are unavailable." } } }, "TransactionAmount": { "type": "object", "properties": { "currency": { "$ref": "#/components/schemas/currency" }, "value": { "type": "string" } } }, "PagedTransaction": { "type": "object", "properties": { "transactions": { "type": "array", "items": { "$ref": "#/components/schemas/Transaction" } }, "links": { "type": "array", "items": { "$ref": "#/components/schemas/PaginationLink" } } } }, "currency": { "type": "string", "description": "3 letter currency code for the account following ISO 4217.", "enum": [ "NOK", "EUR", "SEK", "DKK" ] }, "ApiException": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique identifier for an error, used for debugging purposes. In connection with error reporting to Neonomics, it is called correlation ID.\n" }, "errorCode": { "type": "string", "description": "Error code that identifies the error scenario. Description of error codes is available at Documentation > Development > Error Codes." }, "message": { "type": "string", "description": "Text description of an error." }, "source": { "type": "string", "description": "Identifies the source of an error. \"example\": \"C\" indicates a client error.\n" }, "type": { "type": "string", "description": "Categorization of an error as either 'FATAL', 'NETWORK', 'BAD_REQUEST', 'AUTH' or 'CONSENT'.\nThe error types are described in Documentation > Development > Error Codes.\n" }, "timestamp": { "type": "string" }, "links": { "type": "array", "description": "Array of link objects related to the error. The meta object contains the sessionId.", "items": { "$ref": "#/components/schemas/links" } } } }, "links": { "type": "object", "properties": { "type": { "type": "string", "description": "HTTP Method type of the link." }, "rel": { "type": "string", "description": "API Operation related to the link." }, "href": { "type": "string", "description": "Use this URL to call the consent endpoint, which will return the bank's authentication URL." }, "meta": { "type": "object", "description": "This object contains an id which is the current sessionId." } } } }, "responses": { "510": { "description": "Returned when the request is invalid due to client-side issues, such as missing or incorrect parameters. Check your request and refer to the [Client Error Codes](https://docs.neonomics.io/docs/error-codes#client-errors-10001999) for details.\n", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiException" } } } }, "520": { "description": "Indicates a problem within the Neonomics platform. This error is not caused by your request. See [Neonomics Error Codes](https://docs.neonomics.io/docs/error-codes#neonomics-errors-30003999) for troubleshooting steps.\n", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiException" } } } }, "530": { "description": "Returned when the bank encounters an error processing your request. Review the [Bank Error Codes](https://docs.neonomics.io/docs/error-codes#bank-errors-40005999) for more information and possible solutions.\n", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiException" } } } } } }, "security": [ { "bearerAuth": [] } ] } ```