List Bulk Transfers

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

{
  "bulk_transfers": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "initiator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2025-04-22T12:00:00Z",
      "updated_at": "2025-04-22T12:00:00Z",
      "total_count": 400,
      "completed_count": 200,
      "failed_count": 150,
      "pending_count": 50,
      "results": [
        {
          "client_transfer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "transfer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "errors": [
            {
              "errors": [
                {
                  "code": "<string>",
                  "detail": "<string>"
                }
              ]
            }
          ],
          "status": "pending"
        }
      ]
    }
  ],
  "meta": {
    "current_page": 2,
    "next_page": 3,
    "prev_page": 1,
    "total_pages": 11,
    "total_count": 210,
    "per_page": 20
  }
}

GET

sepa

bulk_transfers

List Bulk Transfers

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

{
  "bulk_transfers": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "initiator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2025-04-22T12:00:00Z",
      "updated_at": "2025-04-22T12:00:00Z",
      "total_count": 400,
      "completed_count": 200,
      "failed_count": 150,
      "pending_count": 50,
      "results": [
        {
          "client_transfer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "transfer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "errors": [
            {
              "errors": [
                {
                  "code": "<string>",
                  "detail": "<string>"
                }
              ]
            }
          ],
          "status": "pending"
        }
      ]
    }
  ],
  "meta": {
    "current_page": 2,
    "next_page": 3,
    "prev_page": 1,
    "total_pages": 11,
    "total_count": 210,
    "per_page": 20
  }
}

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

page

integer

default:1

Page number for pagination. Must be greater than 0.

Required range: x >= 1

per_page

integer

default:100

Number of records per page. Must be between 1 and 100.

Required range: 1 <= x <= 100

Response

List of SEPA Bulk transfers retrieved successfully

bulk_transfers

object[]

required

Show child attributes

bulk_transfers.id

string<uuid>

required

Unique identifier for the bulk transfer job.

bulk_transfers.initiator_id

string<uuid>

required

Unique identifier for the member that created the BulkTransfer.

bulk_transfers.created_at

string<date-time>

required

UTC, the time at which the bulk transfer was first recorded.

Example:

"2025-04-22T12:00:00Z"

bulk_transfers.updated_at

string<date-time>

required

UTC, the time at which the bulk transfer was last updated.

Example:

"2025-04-22T12:00:00Z"

bulk_transfers.total_count

integer

required

Total number of transfers in the job.

Example:

400

bulk_transfers.completed_count

integer

required

Total number of transfers successfully completed in the job.

Example:

200

bulk_transfers.failed_count

integer

required

Total number of transfers failed in the job.

Example:

150

bulk_transfers.pending_count

integer

required

Total number of transfers pending in the job.

Example:

50

bulk_transfers.results

object[]

required

Detailed status of each individual transfer in the job.

Show child attributes

bulk_transfers.results.client_transfer_id

string<uuid>

required

Client-provided key to identify the transfer within the job.

bulk_transfers.results.transfer_id

string<uuid> | null

required

ID of the created transfer (populated if the status=completed).

bulk_transfers.results.errors

Errors · object[] | null

required

List of errors for the transfer (populated if the status=failed).

Show child attributes

bulk_transfers.results.errors.errors

object[]

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

bulk_transfers.results.errors.errors.code

string

required

Error code.

bulk_transfers.results.errors.errors.detail

string

required

Human readable error that explains error code.

bulk_transfers.results.status

enum<string>

required

Available options:

pending,

completed,

failed

Business API

Onboarding API

List Bulk Transfers

Authorizations

Headers

Query Parameters

Response