Get Bulk Transfer

curl --request GET \
  --url https://thirdparty.qonto.com/v2/sepa/bulk_transfers/{id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://thirdparty.qonto.com/v2/sepa/bulk_transfers/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://thirdparty.qonto.com/v2/sepa/bulk_transfers/{id}', 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/sepa/bulk_transfers/{id}",
  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/sepa/bulk_transfers/{id}"

	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))

}

HttpResponse<String> response = Unirest.get("https://thirdparty.qonto.com/v2/sepa/bulk_transfers/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://thirdparty.qonto.com/v2/sepa/bulk_transfers/{id}")

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

{
  "bulk_transfer": {
    "id": "fe1ed7b6-4fee-4036-aaaa-43e1d3154ab3",
    "initiator_id": "f8d96abb-63fe-4a1d-bbd5-10f76eec2e6f",
    "created_at": "2025-04-10T10:00:00Z",
    "updated_at": "2025-04-10T10:05:00Z",
    "total_count": 400,
    "completed_count": 300,
    "failed_count": 10,
    "pending_count": 90,
    "results": [
      {
        "client_transfer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "status": "completed",
        "transfer_id": "027f1410-3749-4c42-a678-31c6f158e652",
        "errors": null
      },
      {
        "client_transfer_id": "10f2bb10-9c81-42a0-a163-b45c3be14807",
        "status": "failed",
        "transfer_id": null,
        "errors": [
          {
            "code": "invalid",
            "detail": "Invalid IBAN",
            "source": {
              "pointer": "/bank_account_id"
            }
          }
        ]
      },
      {
        "client_transfer_id": "be134b6b-6832-49cc-9b04-3a106dab27c7",
        "status": "pending",
        "transfer_id": null,
        "errors": null
      }
    ]
  }
}

Bulk Transfers

Get Bulk Transfer

OAuth scope: organization.read

Retrieves the current status of a bulk transfer and the progress of individual transfers.

Returns a simple JSON response with job-level status and per-transfer details.

If there was a failure to create one of the transfers, you should be able to identify which transfer that was based on the client_transfer_id value provided. This makes it easy to pinpoint the exact transfer and property that caused the issue, allowing for quick troubleshooting and resolution.

The status of the transfer result does not correspond to the actual transfer status. A transfer can be created but fail once Qonto tried to process it. Use the /v2/sepa/transfers?ids[]=1&ids[]=2&ids[]=n resource to fetch the actual transfers. You can filter up to 100 transfer IDs at a time.

GET

sepa

bulk_transfers

{id}

Get Bulk Transfer

curl --request GET \
  --url https://thirdparty.qonto.com/v2/sepa/bulk_transfers/{id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://thirdparty.qonto.com/v2/sepa/bulk_transfers/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://thirdparty.qonto.com/v2/sepa/bulk_transfers/{id}', 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/sepa/bulk_transfers/{id}",
  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/sepa/bulk_transfers/{id}"

	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))

}

HttpResponse<String> response = Unirest.get("https://thirdparty.qonto.com/v2/sepa/bulk_transfers/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://thirdparty.qonto.com/v2/sepa/bulk_transfers/{id}")

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

{
  "bulk_transfer": {
    "id": "fe1ed7b6-4fee-4036-aaaa-43e1d3154ab3",
    "initiator_id": "f8d96abb-63fe-4a1d-bbd5-10f76eec2e6f",
    "created_at": "2025-04-10T10:00:00Z",
    "updated_at": "2025-04-10T10:05:00Z",
    "total_count": 400,
    "completed_count": 300,
    "failed_count": 10,
    "pending_count": 90,
    "results": [
      {
        "client_transfer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "status": "completed",
        "transfer_id": "027f1410-3749-4c42-a678-31c6f158e652",
        "errors": null
      },
      {
        "client_transfer_id": "10f2bb10-9c81-42a0-a163-b45c3be14807",
        "status": "failed",
        "transfer_id": null,
        "errors": [
          {
            "code": "invalid",
            "detail": "Invalid IBAN",
            "source": {
              "pointer": "/bank_account_id"
            }
          }
        ]
      },
      {
        "client_transfer_id": "be134b6b-6832-49cc-9b04-3a106dab27c7",
        "status": "pending",
        "transfer_id": null,
        "errors": null
      }
    ]
  }
}

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.

Path Parameters

string<uuid>

required

Unique identifier of the bulk transfer.

Response

Successfully retrieved the job status

bulk_transfer

object

required

Show child attributes

List Bulk Transfers Create a Bulk Transfer

⌘I

Business API

Onboarding API

Get Bulk Transfer

Authorizations

Headers

Path Parameters

Response