--- updatedAt: 2025-03-11T12:33:08.000Z agentTools: projectIndex: https://docs.neonomics.io/llms.txt --- # /ics/v3/accounts/{id}/transactionDetails/{transactionId} Returns transaction details for a specific transaction. Limitations: 1. DNB only provides data for corporate accounts, for retail accounts bank return error. 2. This API is currently supports below listed bank. More banks will be added once support is provided a) DNB b) Banks managed by Evry (SpareBank Group + Handelsbanken Norway) Note: For DNB corporate accounts there will be some extra info provided like creditor and debtor details which are not available in transaction List. Also Bank does not return all fields for each transactions. If any field is not coming in response that means bank doesn't provide that # 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}/transactionDetails/{transactionId}": { "get": { "tags": [ "Accounts" ], "operationId": "getTransactionsDetailsByTransactionId", "description": "Returns transaction details for a specific transaction.\nLimitations: \n1. DNB only provides data for corporate accounts, for retail accounts bank return error.\n2. This API is currently supports below listed bank. More banks will be added once support is provided\n a) DNB\n b) Banks managed by Evry (SpareBank Group + Handelsbanken Norway)\nNote: For DNB corporate accounts there will be some extra info provided like creditor and debtor details which \nare not available in transaction List. Also Bank does not return all fields for each transactions. \nIf any field is not coming in response that means bank doesn't provide that\n", "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": "transactionId", "in": "path", "required": true, "schema": { "type": "string" } }, { "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": { "type": "array", "items": { "$ref": "#/components/schemas/DetailedTransaction" } }, "examples": { "withAllFields": { "summary": "Full response with all available fields", "description": "Not all fields are returned for every transaction — availability depends on the bank and account type.", "value": [ { "transactionId": "enc!!b1SEkuc7IrTrSqTRO3wmshJpiaQESFi0nf5yAMZhvdOvNHTYng3geuyl8yUCn6er", "endToEndId": "E2E-20251007-001", "bookingDate": "2025-10-07", "valueDate": "2025-10-07", "bankTransactionCode": "PMNT-ICDT-ESCT", "proprietaryBankTransactionCode": "PURCHASE", "transactionAmount": { "amount": "49.90", "currency": "EUR" }, "currencyExchange": { "sourceCurrency": "USD", "targetCurrency": "EUR", "exchangeRate": "0.9210", "unitCurrency": "USD", "quotationDate": "2025-10-06", "contractIdentification": "FX-20251006-0042" }, "creditorId": "CR-001", "creditorName": "Acme AS", "creditorAccount": { "bban": "86011117947", "iban": "NO9386011117947", "maskedPan": "************1234", "msisdn": "+4799999999", "currency": "EUR" }, "creditorAgent": "DNBANOKKXXX", "ultimateCreditor": "Acme Group", "debtorName": "John Doe", "debtorAccount": { "bban": "60061232779", "iban": "NO8860061232779", "currency": "EUR" }, "debtorAgent": "NDEANOKK", "ultimateDebtor": "Jane Doe", "remittanceInformationUnstructuredArray": [ "Invoice payment October" ], "remittanceInformationStructuredArray": [ { "reference": "1234567890", "referenceType": "KID", "referenceIssuer": "Acme AS" } ], "additionalInformation": "Monthly subscription payment", "checkId": "CHK-00456", "transactionDateTime": "2025-10-07T10:34:00.000Z", "transactionType": "PURCHASE", "instructionIdentification": "INSTR-20251007-0099", "entryReference": "ENTRY-20251007-0099", "mandateId": "MD-00123", "merchantCategoryCode": "5411", "merchantName": "REMA 1000", "cardTransactionTypeCode": "PURCHASE", "cardAcceptorAddress": { "streetName": "Karl Johans gate", "buildingNumber": "1", "postCode": "0154", "townName": "Oslo", "countrySubDivision": "Oslo", "country": "NO", "unstructured": "Karl Johans gate 1, 0154 Oslo" }, "purposeCode": "GDDS", "links": { "href": "https://api.neonomics.io/ics/v3/accounts/enc!!xyz/transactionDetails/enc!!b1SE", "verbs": [ "GET" ] } } ] } } } } }, "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": { "DetailedTransaction": { "type": "object", "properties": { "transactionId": { "type": "string", "description": "Unique identifier for the transaction." }, "endToEndId": { "type": "string", "description": "End-to-end identifier assigned by the originating party." }, "bookingDate": { "type": "string", "format": "date", "description": "Date when the transaction was booked, formatted following ISO 8601 (YYYY-MM-DD)." }, "valueDate": { "type": "string", "format": "date", "description": "Date when the transaction value was applied, formatted following ISO 8601 (YYYY-MM-DD)." }, "bankTransactionCode": { "type": "string", "description": "ISO 20022 bank transaction code (e.g. PMNT-RCDT-ESCT)." }, "proprietaryBankTransactionCode": { "type": "string", "description": "Bank-specific transaction code." }, "transactionAmount": { "type": "object", "description": "Amount and currency of the transaction.", "properties": { "amount": { "type": "string", "description": "Transaction amount as a decimal number (e.g. 299.00)." }, "currency": { "type": "string", "description": "3-letter currency code following ISO 4217." } } }, "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 following ISO 4217." }, "exchangeRate": { "type": "string", "description": "Rate used to convert source currency to target currency." }, "unitCurrency": { "type": "string", "description": "Currency in which the exchange rate is expressed following ISO 4217." }, "quotationDate": { "type": "string", "format": "date", "description": "Date the exchange rate was quoted." }, "contractIdentification": { "type": "string", "description": "Reference to the underlying foreign exchange contract." } } }, "creditorId": { "type": "string", "description": "Identifier of the creditor." }, "creditorName": { "type": "string", "description": "Name of the creditor." }, "creditorAccount": { "type": "object", "description": "Account details of the creditor.", "properties": { "bban": { "type": "string", "description": "Basic Bank Account Number of the creditor." }, "iban": { "type": "string", "description": "International Bank Account Number of the creditor." }, "maskedPan": { "type": "string", "description": "Masked Primary Account Number of the creditor." }, "msisdn": { "type": "string", "description": "Mobile number used as account identifier (MSISDN) of the creditor." }, "pan": { "type": "string", "description": "Primary Account Number of the creditor." }, "currency": { "type": "string", "description": "3-letter currency code of the creditor account following ISO 4217." } } }, "creditorAgent": { "type": "string", "description": "BIC code of the creditor's bank (agent)." }, "ultimateCreditor": { "type": "string", "description": "Ultimate party to which the creditor owes funds." }, "debtorName": { "type": "string", "description": "Name of the debtor." }, "debtorAccount": { "type": "object", "description": "Account details of the debtor.", "properties": { "bban": { "type": "string", "description": "Basic Bank Account Number of the debtor." }, "iban": { "type": "string", "description": "International Bank Account Number of the debtor." }, "currency": { "type": "string", "description": "3-letter currency code of the debtor account following ISO 4217." } } }, "debtorAgent": { "type": "string", "description": "BIC code of the debtor's bank (agent)." }, "ultimateDebtor": { "type": "string", "description": "Ultimate party that owes funds to the creditor." }, "remittanceInformationUnstructuredArray": { "type": "array", "description": "Free-form remittance information as provided by the originating party.", "items": { "type": "string" } }, "remittanceInformationStructuredArray": { "type": "array", "description": "Structured remittance information references.", "items": { "type": "object", "properties": { "reference": { "type": "string", "description": "Reference number of the remittance information." }, "referenceType": { "type": "string", "description": "Type of reference (e.g. SCOR, BBAN)." }, "referenceIssuer": { "type": "string", "description": "Entity that issued the reference." } } } }, "additionalInformation": { "type": "string", "description": "Additional free-text information about the transaction." }, "checkId": { "type": "string", "description": "Identifier of the check used in the transaction." }, "transactionDateTime": { "type": "string", "format": "date-time", "description": "Date and time when the transaction was executed, formatted following ISO8601." }, "transactionType": { "type": "string", "description": "Transaction type as provided by the bank." }, "instructionIdentification": { "type": "string", "description": "Unique identification assigned by an instructing party to unambiguously identify the instruction." }, "entryReference": { "type": "string", "description": "Reference assigned by the account servicer to identify the entry in the account statement." }, "mandateId": { "type": "string", "description": "Mandate identifier for direct debit or standing order transactions." }, "merchantCategoryCode": { "type": "string", "description": "4-digit Merchant Category Code (MCC) identifying the type of business." }, "merchantName": { "type": "string", "description": "Merchant name as returned by the bank." }, "cardTransactionTypeCode": { "type": "string", "description": "Card transaction type code as provided by the bank." }, "cardAcceptorAddress": { "$ref": "#/components/schemas/CardAcceptorAddress" }, "purposeCode": { "type": "string", "description": "Purpose code of the transaction as defined by ISO 20022." }, "links": { "type": "object", "description": "Hypermedia links related to the transaction.", "properties": { "href": { "type": "string", "description": "URL of the linked resource." }, "verbs": { "type": "array", "description": "HTTP methods supported by the linked resource.", "items": { "type": "string" } } } } }, "required": [ "transactionId", "transactionAmount", "bookingDate" ] }, "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." } } }, "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": [] } ] } ```