--- updatedAt: 2024-11-14T20:14:37.000Z agentTools: projectIndex: https://docs.neonomics.io/llms.txt --- # Account Data How to fetch account data using the Neonomics API. To get account data you will need to complete these two steps: 1. Fetching accounts using the accounts endpoint to get an array of end-user accounts. 2. Getting transactions by using an account id and the transactions endpoint. > πŸ“˜ Info > > You need to complete the development [quickstart](https://docs.neonomics.io/docs/development-quickstart) and the customer [consent guide](https://docs.neonomics.io/docs/consent-authorization-and-sca) before starting this guide. A valid access\_token and sessionId are needed to follow this guide. # Step 1: Fetching accounts To fetch [accounts](https://docs.neonomics.io/reference/getallaccounts) API, you will need to make a `GET` request to the `/accounts/` Neonomics API endpoint. This endpoint is used to get all the accounts associated with a session. A `sessionId` is the link between an end-user and a bank. Use the **curl** `GET` request below to fetch the accounts. You will need to use the `access_token` and `sessionId` – generated in the Development [quickstart](https://docs.neonomics.io/docs/development-quickstart) – in place of `` and ``. The endpoint uses the header parameter `x-psu-ip-address`, which contains the end-user's IP address. It is required if the end-user is requesting the account data. If it is a background refresh request then the `x-psu-ip-address` can be empty. *PSU* is an acronym of *Payment Service User*, which is an *end-user*. The term is used in PSD2 contexts. **Request:** ```curl curl -X GET -H "Authorization:Bearer \" -H "Accept:application/json" -H "x-device-id:example_id_for_quickstart" -H "x-psu-ip-address:109.74.179.3" -H "x-session-id:\" ``` Please note that bank details used in this document are test details which are only used in the sandbox. Below are two example responses to the request above, both with the status code `200`. You will, in some cases, instead get a response with the status code `510` together with error code `1426`, which means that end-user [consent](https://docs.neonomics.io/reference/initiateconsent) is required. Our Consent guide gives an example of [how to get end-user consent](https://docs.neonomics.io/docs/consent-authorization-and-sca#how-to-get-an-end-users-consent) in such cases. Response examples: ```json [ { "id": "ACCOUNT_1_ID", "iban": "NO2390412263056", "bban": "90412263056", "accountName": "Daily account", "accountType": "TAXE", "ownerName": "Joanna Doe", "displayName": "My account", "balances": [ { "amount": "9049.32", "currency": "NOK", "type": "CLSG" }, { "amount": "10000", "currency": "NOK", "type": "EXPN" } ] } ] ``` ```json [ { "id": "ACCOUNT_2_ID", "iban": "GB29NWBK60161331926819", "bban": "NWBK60161331926819", "sortCodeAccountNumber": "60161331926819", "accountName": "Current account", "accountType": "CACC", "ownerName": "JoΓ£o Doe", "displayName": "Conta corrente", "balances": [ { "amount": "10000", "currency": "GBP", "type": "CLSG" }, { "amount": "11086.17", "currency": "GBP", "type": "EXPN" } ] } ] ``` This response contains an array of [accounts](https://docs.neonomics.io/reference/getallaccounts) API objects for the `sessionId` used in the curl request. The `balances` attribute is an array of *balance* objects. Each one has a type attribute that is an [ISO code](https://docs.neonomics.io/docs/iso-codes) that represents the *type* of balance. A bank account can have multiple balances for example: * `CLSG` - The balance at the end of the bank’s business day. * `AVLB` - The balance that is at the disposal of the account owner at that date specified. Save an account `id` from the response above. It will be needed in the next step. # Step 2: Getting transactions Now that you have a list of your *end-user's* bank accounts, you can get the accounts' *transactions*. To fetch [transactions](https://docs.neonomics.io/reference/getpaginatedtransactionsbyaccountid) API, you will need to make a GET request to the `/accounts//transactions` Neonomics API endpoint. This endpoint is used to get all the transactions for a specific account. Use the **curl** `GET` request below to fetch the account transactions. You will need to use the `access_token` and `sessionId` – generated in the Development quickstart – in place of `` and ``. Also, you will need to replace the`` in the URL with the account `id` generated in step one. **Request:** ```curl curl -X GET \/transactions -H "Authorization:Bearer \" -H "Accept:application/json" -H "x-device-id:example_id_for_quickstart" -H "x-psu-ip-address:109.74.179.3" -H "x-session-id:\" ``` Below is an example response similar to the one returned from the request above. It is an array of transactions for the *account* `id` you provided in the **curl** requests URL. **Response:** ```json [ { "id": "TRANSACTION_1_ID", "transactionReference": "Credit interest", "transactionAmount": { "currency": "NOK", "value": "10.59" }, "creditDebitIndicator": "CRDT", "bookingDate": "2021-08-31T00:00:00.000Z", "valueDate": "2021-08-31T00:00:00.000Z", "bookingDate": "2021-08-31T00:00:00.000Z", "valueDate": "2021-08-31T00:00:00.000Z", "counterpartyAccount": "DE89370400440532013000", "counterpartyName": "Farmer's bank", "counterpartyAgent": "HASPDEHHXXX" }, { "id": "", "transactionReference": "Salary", "transactionAmount": { "currency": "NOK", "value": "59000.0" }, "creditDebitIndicator": "CRDT", "bookingDate": "2021-09-15T00:00:00.000Z", "valueDate": "2021-09-15T00:00:00.000Z", "counterpartyAccount": "", "counterpartyName": "Economy dept.", "counterpartyAgent": "" }, { "id": "", "transactionReference": "Instalment", "transactionAmount": { "currency": "NOK", "value": "1000.0" }, "creditDebitIndicator": "DBIT", "bookingDate": "2021-09-15T00:00:00.000Z", "valueDate": "2021-09-15T00:00:00.000Z", "valueDate": "2021-09-15T00:00:00.000Z", "counterpartyAccount": "DE89370400440532013000", "counterpartyName": "The building society", "counterpartyAgent": "AAAABBCCXXX" } ] ``` Brilliant! You have now fetched account and transaction data for one *end-user* bank account πŸ„β€β™€οΈ