Skip to main content
GET
List international transfers
Authentication: API key OAuth 2.0
Scope: organization.read Sensitive
Results are scoped to the authenticated organization and support filtering by bank account, status and update date, plus pagination.
This endpoint is still in beta. Please get in touch with our team if you have any question or feedback: here.

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.

Scopes

organization.read

Retrieve organization, bank accounts, transactions, transfers, beneficiaries, labels, memberships, requests & statements

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

Only return transfers debited from this bank account.

Example:

"0196edb0-9b6e-7554-9864-d111285a0a42"

status
enum<string>[]

Filter by one or more transfer statuses. Repeat the parameter to pass several values (e.g. ?status=pending&status=processing).

Available options:
pending,
processing,
settled,
declined,
canceled
updated_at_from
string<date-time>

Only return transfers updated at or after this timestamp (RFC 3339).

Example:

"2026-01-01T00:00:00Z"

updated_at_to
string<date-time>

Only return transfers updated at or before this timestamp (RFC 3339).

Example:

"2026-02-01T00:00:00Z"

page
integer
default:1

Returned page (cf. Pagination).

Required range: x >= 1
per_page
integer
default:25

Number of transfers per page (cf. Pagination). Values above the maximum are capped.

Required range: 1 <= x <= 100

Response

Returns the organization's international transfers.

transfers
object[]
meta
object

Metadata for paginated responses