Get Bulk Transfer

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

{
  "bulk_transfer": {
    "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"
      }
    ]
  }
}

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

{
  "bulk_transfer": {
    "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"
      }
    ]
  }
}

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

bulk_transfer.id

string<uuid>

required

Unique identifier for the bulk transfer job.

bulk_transfer.initiator_id

string<uuid>

required

Unique identifier for the member that created the BulkTransfer.

bulk_transfer.created_at

string<date-time>

required

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

Example:

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

bulk_transfer.updated_at

string<date-time>

required

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

Example:

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

bulk_transfer.total_count

integer

required

Total number of transfers in the job.

Example:

400

bulk_transfer.completed_count

integer

required

Total number of transfers successfully completed in the job.

Example:

200

bulk_transfer.failed_count

integer

required

Total number of transfers failed in the job.

Example:

150

bulk_transfer.pending_count

integer

required

Total number of transfers pending in the job.

Example:

50

bulk_transfer.results

object[]

required

Detailed status of each individual transfer in the job.

Show child attributes

bulk_transfer.results.client_transfer_id

string<uuid>

required

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

bulk_transfer.results.transfer_id

string<uuid> | null

required

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

bulk_transfer.results.errors

Errors · object[] | null

required

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

Show child attributes

bulk_transfer.results.errors.errors

object[]

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

bulk_transfer.results.errors.errors.code

string

required

Error code.

bulk_transfer.results.errors.errors.detail

string

required

Human readable error that explains error code.

bulk_transfer.results.status

enum<string>

required

Available options:

pending,

completed,

failed

List Bulk Transfers Create a Bulk Transfer

⌘I

Business API

Onboarding API

Get Bulk Transfer

Authorizations

Headers

Path Parameters

Response