# List transactions

To fetch a list of transactions, you must have a `user access token` with the `transactions:read` scope. Use the `user access token` to make a request to the Transactions endpoint.

```bash
#Fetch a list of transactions
curl "https://api.tink.com/data/v2/transactions" \
  -H 'Authorization: Bearer {YOUR_USER_ACCESS_TOKEN}'
``` 

Send a request and you receive a list of transactions.

```json
{
  "nextPageToken": "string",
  "transactions": [
    {
      "accountId": "4a2945d1481c4f4b98ab1b135afd96c0",
      "amount": {
        "currencyCode": "GBP",
        "value": {
          "scale": "1",
          "unscaledValue": "-1300"
        }
      },
      "categories": {
        "pfm": {
          "id": "d8f37f7d19c240abb4ef5d5dbebae4ef",
          "name": ""
        }
      },
      "dates": {
        "booked": "2020-12-15",
        "value": "2020-12-15"
      },
      "descriptions": {
        "display": "Tesco",
        "original": "TESCO STORES 3297"
      },
      "id": "d8f37f7d19c240abb4ef5d5dbebae4ef",
      "identifiers": {
        "providerTransactionId": "500015d3-acf3-48cc-9918-9e53738d3692"
      },
      "merchantInformation": {
        "merchantCategoryCode": "string",
        "merchantName": "string"
      },
      "providerMutability": "MUTABILITY_UNDEFINED",
      "reference": "string",
      "status": "BOOKED",
      "types": {
        "financialInstitutionTypeCode": "DEB",
        "type": "DEFAULT"
      }
    }
  ]
}
``` 

__Optional Parameters__

In your request, you must provide the `user access token`. Optionally, specify query parameters to filter your results. These parameters are:

| PARAMETER     | DESCRIPTION     |
| ---------- | ---------- |
| accountIdIn={your_account_id}| Returns transactions only for a given account (this parameter may be repeated to specify multiple accounts)      |
| statusIn={transaction_status}       | If set, only transactions with the given status will be returned. This parameter may be repeated to specify multiple statuses.       |
| pageSize={number}       | The maximum number of items to return. This endpoint will not return more than 100 transactions per page.       |
| pageToken={next_page_token}       | Return the next page of transactions (if you have set pageSize)       |
| bookedDateGte={date}       | Specified as the earliest booked date of transactions used for filtering and with the ISO-8061 date format (YYYY-MM-DD). If the query parameter is not provided time range will be calculated using the booked date of the earliest transaction available.       |
| bookedDateLte={date}       | Specified as the latest booked date of transactions used for filtering and with the ISO-8061 date format (YYYY-MM-DD). If the query parameter is not provided time range will be calculated until today.       |

```bash
#Request example with optional parameters
curl -X GET 'https://api.tink.com/data/v2/transactions' \
  -H 'Authorization: Bearer {YOUR_USER_ACCESS_TOKEN}' \
  -d 'accountIdIn={YOUR_ACCOUNT_ID}' \
  -d 'statusIn={TRANSACTION_STATUS}' \
  -d 'pageSize={NUMBER}' \
  -d 'pageToken={NEXT_PAGE_TOKEN}' \
  -d 'bookedDateGte={BOOKED_DATE_GTE}' \
  -d 'bookedDateLte={BOOKED_DATE_LTE}' 
```