GET
/
api
/
v1
/
transfers
List Transfer Transactions with Filtering
curl --request GET \
  --url http://localhost:8080/api/v1/transfers
[
  {
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "cr_bank_bic": "<string>",
    "cr_iban": "<string>",
    "cr_name": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "credit_amount": "1000.00",
    "credit_currency": "<string>",
    "debit_amount": "1000.00",
    "debit_currency": "<string>",
    "dr_bank_bic": "<string>",
    "dr_iban": "<string>",
    "dr_name": "<string>",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "is_instant": true,
    "purpose": "<string>",
    "settlement_date": "2023-12-25",
    "unique_reference": "<string>",
    "updated_at": "2023-11-07T05:31:56Z",
    "bank_partner_id": "<string>",
    "bank_partner_trx_id": 123,
    "beneficiary_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "category_purpose_code": "<string>",
    "cr_account_id": "<string>",
    "cr_address": "<string>",
    "cr_bank_name": "<string>",
    "cr_city": "<string>",
    "cr_country_code": "<string>",
    "cr_postal_code": "<string>",
    "dr_account_id": "<string>",
    "dr_address": "<string>",
    "dr_bank_name": "<string>",
    "dr_city": "<string>",
    "dr_country_code": "<string>",
    "dr_postal_code": "<string>",
    "exchange_rate": "1.085600",
    "fx_fee_amount": "5.00",
    "parent_transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "purpose_code": "<string>",
    "signed_at": "2023-11-07T05:31:56Z",
    "status_reason": "<string>",
    "status_reason_code": "<string>",
    "structured_reference": "<string>",
    "structured_reference_issuer": "<string>",
    "third_party_status": "<string>",
    "third_party_status_code": "<string>",
    "third_party_status_reason": "<string>"
  }
]

Query Parameters

​
limit
integer<int64> | null

Maximum number of results (default: 50, max: 100)

​
offset
integer<int64> | null

Number of results to skip

​
account_id
string<uuid> | null

Filter by account ID

​
beneficiary_id
string<uuid> | null

Filter by beneficiary ID

​
direction
null | enum<string>

Filter by direction Transfer Direction - Indicates if money is coming in or going out

Available options:
INBOUND,
OUTBOUND
​
status
null | enum<string>

Filter by status Transfer Status - Current status of the transfer transaction

Available options:
CREATED,
SIGNED,
REVIEW,
READY_TO_CLEAR,
SENT_TO_PACK,
PACKED,
SENT_TO_CLEAR,
COMPLETED,
SOME_PROBLEMS,
CANCELLED,
REJECTED,
INVALID,
ACCEPTED,
TO_SIGN,
RESERVED,
TO_RESERVE,
RECEIVED,
DROPPED,
ON_HOLD,
READY_FOR_SCREENING,
AML_APPROVED,
AML_REJECTED,
MANUAL_ACTION,
CREDIT_TECH_BALANCE,
TO_RESEND,
MANUAL_REJECTED,
TO_CANCEL,
BLACKLIST_SCANNING,
AML_SCANNING,
TO_RETURN
​
transfer_type
null | enum<string>

Filter by transfer type Transfer Type - The type/nature of the transfer

Available options:
FEE,
PAYMENT,
PAYMENT_CANCELLATION,
PAYMENT_RETURN,
FEE_CANCELLATION,
CCY_EXCHANGE,
ADJUSTMENT,
PAYMENT_TECHNICAL_REVERSAL,
PAYMENT_REVERSAL,
CARD_AUTH,
CARD_ADVICE,
CARD_REVERSAL,
FX_POSITION_CLOSING,
CARD_CLEARING
​
method
null | enum<string>

Filter by method Transfer Method - The payment method/rail used

Available options:
SEPA,
INTERNAL,
SDD,
SDD_INTERNAL,
INST,
CARD,
SWIFT,
DOMESTIC
​
currency
string | null

Filter by currency

​
from_date
string<date> | null

Filter by date range (from)

​
to_date
string<date> | null

Filter by date range (to)

​
search
string | null

Search in unique_reference, purpose, cr_name, dr_name

Response

List of transfers

​
account_id
string<uuid>
required
​
cr_bank_bic
string
required
​
cr_iban
string
required
​
cr_name
string
required
​
created_at
string<date-time>
required
​
credit_amount
string
required
Example:

"1000.00"

​
credit_currency
string
required
​
debit_amount
string
required
Example:

"1000.00"

​
debit_currency
string
required
​
direction
enum<string>
required

Transfer Direction - Indicates if money is coming in or going out

Available options:
INBOUND,
OUTBOUND
​
dr_bank_bic
string
required
​
dr_iban
string
required
​
dr_name
string
required
​
id
string<uuid>
required
​
is_instant
boolean
required
​
method
enum<string>
required

Transfer Method - The payment method/rail used

Available options:
SEPA,
INTERNAL,
SDD,
SDD_INTERNAL,
INST,
CARD,
SWIFT,
DOMESTIC
​
purpose
string
required
​
settlement_date
string<date>
required
​
status
enum<string>
required

Transfer Status - Current status of the transfer transaction

Available options:
CREATED,
SIGNED,
REVIEW,
READY_TO_CLEAR,
SENT_TO_PACK,
PACKED,
SENT_TO_CLEAR,
COMPLETED,
SOME_PROBLEMS,
CANCELLED,
REJECTED,
INVALID,
ACCEPTED,
TO_SIGN,
RESERVED,
TO_RESERVE,
RECEIVED,
DROPPED,
ON_HOLD,
READY_FOR_SCREENING,
AML_APPROVED,
AML_REJECTED,
MANUAL_ACTION,
CREDIT_TECH_BALANCE,
TO_RESEND,
MANUAL_REJECTED,
TO_CANCEL,
BLACKLIST_SCANNING,
AML_SCANNING,
TO_RETURN
​
transfer_type
enum<string>
required

Transfer Type - The type/nature of the transfer

Available options:
FEE,
PAYMENT,
PAYMENT_CANCELLATION,
PAYMENT_RETURN,
FEE_CANCELLATION,
CCY_EXCHANGE,
ADJUSTMENT,
PAYMENT_TECHNICAL_REVERSAL,
PAYMENT_REVERSAL,
CARD_AUTH,
CARD_ADVICE,
CARD_REVERSAL,
FX_POSITION_CLOSING,
CARD_CLEARING
​
unique_reference
string
required
​
updated_at
string<date-time>
required
​
bank_partner_id
string | null
​
bank_partner_trx_id
integer<int64> | null
​
beneficiary_id
string<uuid> | null
​
category_purpose_code
string | null
​
cr_account_id
string | null
​
cr_address
string | null
​
cr_bank_name
string | null
​
cr_city
string | null
​
cr_country_code
string | null
​
cr_postal_code
string | null
​
dr_account_id
string | null
​
dr_address
string | null
​
dr_bank_name
string | null
​
dr_city
string | null
​
dr_country_code
string | null
​
dr_postal_code
string | null
​
exchange_rate
string | null
Example:

"1.085600"

​
fx_fee_amount
string | null
Example:

"5.00"

​
parent_transaction_id
string<uuid> | null
​
purpose_code
string | null
​
signed_at
string<date-time> | null
​
status_reason
string | null
​
status_reason_code
string | null
​
structured_reference
string | null
​
structured_reference_issuer
string | null
​
third_party_status
string | null
​
third_party_status_code
string | null
​
third_party_status_reason
string | null