List transactions

curl --request GET \
  --url https://thirdparty.qonto.com/v2/transactions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://thirdparty.qonto.com/v2/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://thirdparty.qonto.com/v2/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://thirdparty.qonto.com/v2/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://thirdparty.qonto.com/v2/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "transactions": [
    {
      "id": "df346899-3595-421a-8b26-f9d9616ce496",
      "transaction_id": "super-transaction-7468",
      "amount": 0.43,
      "amount_cents": 43,
      "settled_balance": 111.1,
      "settled_balance_cents": 11110,
      "attachment_ids": [],
      "logo": {},
      "local_amount": 0.43,
      "local_amount_cents": 43,
      "side": "debit",
      "operation_type": "transfer",
      "currency": "EUR",
      "local_currency": "EUR",
      "label": "Ferry-Purdy",
      "settled_at": "2021-02-26T08:01:12.000Z",
      "emitted_at": "2021-02-25T16:22:37.000Z",
      "created_at": "2021-02-25T16:22:37.418Z",
      "updated_at": "2021-02-26T08:01:12.000Z",
      "status": "completed",
      "note": "Rhea Ernser",
      "reference": null,
      "vat_amount": null,
      "vat_amount_cents": null,
      "vat_rate": null,
      "initiator_id": "ccdcef78-1aa1-4d44-b991-b10005a4ad1a",
      "label_ids": [
        "6450e541-0a6f-4153-a46e-34d98848e280"
      ],
      "attachment_lost": false,
      "attachment_required": true,
      "card_last_digits": null,
      "category": "other_expense",
      "cashflow_category": {
        "id": "38f3c1d2-2c0a-4e2e-9d0a-1a3a4f5b6c7d",
        "name": "Others"
      },
      "cashflow_subcategory": {
        "id": "7a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
        "name": "Tips"
      },
      "card_id": null,
      "subject_type": "Transfer",
      "bank_account_id": "018f71db-c635-78b5-b90a-ea05de98c2bf",
      "is_external_transaction": false,
      "clean_counterparty_name": "Ferry Purdy",
      "transfer": {
        "counterparty_account_number": "NL93RABO3730976796",
        "counterparty_account_number_format": "IBAN",
        "counterparty_bank_identifier": "RABO",
        "counterparty_bank_identifier_format": "SWIFT_BIC"
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "next_page": null,
    "prev_page": null,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 100
  }
}

GET

transactions

List transactions

curl --request GET \
  --url https://thirdparty.qonto.com/v2/transactions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://thirdparty.qonto.com/v2/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://thirdparty.qonto.com/v2/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://thirdparty.qonto.com/v2/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://thirdparty.qonto.com/v2/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "transactions": [
    {
      "id": "df346899-3595-421a-8b26-f9d9616ce496",
      "transaction_id": "super-transaction-7468",
      "amount": 0.43,
      "amount_cents": 43,
      "settled_balance": 111.1,
      "settled_balance_cents": 11110,
      "attachment_ids": [],
      "logo": {},
      "local_amount": 0.43,
      "local_amount_cents": 43,
      "side": "debit",
      "operation_type": "transfer",
      "currency": "EUR",
      "local_currency": "EUR",
      "label": "Ferry-Purdy",
      "settled_at": "2021-02-26T08:01:12.000Z",
      "emitted_at": "2021-02-25T16:22:37.000Z",
      "created_at": "2021-02-25T16:22:37.418Z",
      "updated_at": "2021-02-26T08:01:12.000Z",
      "status": "completed",
      "note": "Rhea Ernser",
      "reference": null,
      "vat_amount": null,
      "vat_amount_cents": null,
      "vat_rate": null,
      "initiator_id": "ccdcef78-1aa1-4d44-b991-b10005a4ad1a",
      "label_ids": [
        "6450e541-0a6f-4153-a46e-34d98848e280"
      ],
      "attachment_lost": false,
      "attachment_required": true,
      "card_last_digits": null,
      "category": "other_expense",
      "cashflow_category": {
        "id": "38f3c1d2-2c0a-4e2e-9d0a-1a3a4f5b6c7d",
        "name": "Others"
      },
      "cashflow_subcategory": {
        "id": "7a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
        "name": "Tips"
      },
      "card_id": null,
      "subject_type": "Transfer",
      "bank_account_id": "018f71db-c635-78b5-b90a-ea05de98c2bf",
      "is_external_transaction": false,
      "clean_counterparty_name": "Ferry Purdy",
      "transfer": {
        "counterparty_account_number": "NL93RABO3730976796",
        "counterparty_account_number_format": "IBAN",
        "counterparty_bank_identifier": "RABO",
        "counterparty_bank_identifier_format": "SWIFT_BIC"
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "next_page": null,
    "prev_page": null,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 100
  }
}

Authentication: API key OAuth 2.0
Scope: organization.read Sensitive You can filter (ex: only retrieve the latest transactions) and sort this list by using query parameters 👇

All transactions visible in Qonto’s UI can be retrieved, as of API V2.

Authorizations

Authorization

string

header

required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token

string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Query Parameters

bank_account_id

string

id of the bank account for which transactions will be retrieved. Use /v2/organization to get this parameter. If both bank_account_id and iban are specified, bank_account_id takes precedence.

Example:

"018f71db-c635-78b5-b90a-ea05de98c2bf"

iban

string

IBAN of the bank account for which transactions will be retrieved. Use /v2/organization to get this parameter. If both bank_account_id and iban are specified, bank_account_id takes precedence.

Example:

"FR7616798000010000005663951"

includes[]

enum<string>[]

Use this query parameter to embed the associated resources (labels, attachments and/or VAT details) of the transactions in the JSON response.

Available options:

vat_details,

labels,

attachments

status[]

enum<string>[]

Transactions can be filtered by their status property. Possible values:

pending: a transaction that is processing and has impacted the bank account's auth_balance but not its balance;
declined: a transaction that has been declined;
completed: a transaction that is completed, and has impacted the bank account's balance;
reversed: a transaction that has been reversed after being completed.

When not specified, only completed transactions will be returned.

Available options:

pending,

declined,

completed,

reversed

updated_at_from

string

Transactions can be filtered by their updated_at property. This filter can be used in combination with the updated_at_to query parameter to get transactions updated within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

updated_at_to

string

Transactions can be filtered by their updated_at property. This filter can be used in combination with the updated_at_from query parameter to get transactions updated within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

created_at_from

string

Transactions can be filtered by their created_at property. This filter can be used in combination with the created_at_to query parameter to get transactions created within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

created_at_to

string

Transactions can be filtered by their created_at property. This filter can be used in combination with the created_at_from query parameter to get transactions created within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

emitted_at_from

string

Transactions can be filtered by their emitted_at property. This filter can be used in combination with the emitted_at_to query parameter to get transactions emitted within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

emitted_at_to

string

Transactions can be filtered by their emitted_at property. This filter can be used in combination with the emitted_at_from query parameter to get transactions emitted within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

settled_at_from

string

Transactions can be filtered by their settled_at property. This filter can be used in combination with the settled_at_to query parameter to get transactions settled within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

settled_at_to

string

Transactions can be filtered by their settled_at property. This filter can be used in combination with the settled_at_from query parameter to get transactions settled within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

side

enum<string>

Transactions can be filtered by their side property.

Available options:

credit,

debit

operation_type[]

string[]

Transactions can be filtered by their operation_type property.

Example:

"operation_type[]=card&operation_type[]=transfer&operation_type[]=income&operation_type[]=account_remuneration"

with_attachments

boolean

Transactions can be filtered based on the presence of one or more attachments.

sort_by

string

default:settled_at:desc

Sorts transactions, written as property:order.

property: settled_at (default), created_at, updated_at or emitted_at.
order: asc or desc (default).

Either part can be left out:

settled_at is settled_at:desc.
:asc is settled_at:asc.

Pattern: ^(created_at|updated_at|settled_at|emitted_at)?(:(asc|desc)?)?$

Example:

"emitted_at:asc"

page

integer

default:1

Returned page (cf. Pagination). Must be an integer of 1 or more, otherwise the API returns a 422. page × per_page can't exceed 10,000. Past that, the API returns a 422 too. To reach older transactions, narrow the date filters.

Required range: x >= 1

per_page

integer

default:100

Number of transactions per page (cf. Pagination). Values outside the 1 to 100 range are clamped to it. A value that isn't an integer, such as 50.0, is treated as 1.

Response

Returns the list of transactions for the specified bank account.

transactions

object[]

Show child attributes

Introduction

Authentication

Organization & accounts

Transactions & statements

Transfers

Getting paid

Cards

Invoicing

Spend management

Cash flow

Webhooks

Partner endpoints

List transactions

Authorizations

Headers

Query Parameters

Response