Skip to main content
GET
Banka hareketlerini listeler

Yetkilendirmeler

Authorization
string
header
gerekli

Kullanıcı adı anahtar kimliği, parola secret key değeridir. Anahtar aktif olmalı, erişim bitiş tarihi geçmemiş olmalı ve BankaPro erişimine sahip olmalıdır. Firma anahtardan sunucu tarafında belirlenir; istemciden firma kimliği alınmaz. Anahtarın IP kısıtı doluysa istek yalnız listedeki adreslerden kabul edilir. Kimlik bilgileri yalnız HTTPS üzerinden gönderilmelidir.

Başlıklar

x-request-id
string

Opsiyonel izleme kimliği. Değer 1-100 karakter ve yalnız harf, rakam, nokta, alt çizgi, iki nokta veya tire içeriyorsa korunur; aksi halde sunucu yeni bir UUID üretir.

Required string length: 1 - 100
Pattern: ^[A-Za-z0-9._:-]{1,100}$

Sorgu Parametreleri

page
integer
varsayılan:1
Gerekli aralık: x >= 1
pageSize
integer
varsayılan:25
Gerekli aralık: 1 <= x <= 100
q
string

Büyük/küçük harf ve Türkçe karakter farkına duyarsız arama. Hesaplarda ad, banka adı/kodu, hesap kodu ve IBAN aranır. Hareket araması karşı taraf adında ve açıklamanın normalize edilmiş kelime belirteçlerinde çalışır; baPii varsa ayrıca IBAN ve kimlik numarasında da çalışır. İşlem kodu ve alt hesap hareket aramasının kapsamı dışındadır. Açıklama belirteçleri en az üç karakterli kelimelerden üretilir; daha kısa terimler yalnız karşı taraf adında aranır. IBAN veya kimlik numarası niteliğindeki hareket aramaları baPii gerektirir.

Required string length: 2 - 100
accountId
string

Tek banka hesabının hareketleri.

Pattern: ^[a-fA-F0-9]{24}$
Örnek:

"64f000000000000000000001"

currency
string

Para birimi filtresi. Sabit destek listesi yoktur; tüm üç harfli kodlar kabul edilir. TL, ERU ve GPD sırasıyla TRY, EUR ve GBP olarak normalize edilir. TRY filtresi eksik, null veya boş saklanmış para birimi değerlerini de kapsar. Sabit bir liste olmadan herhangi bir üç harfli para/kıymet kodu veya TL. Girdi büyük harfe çevrilir; TL, ERU ve GPD sırasıyla TRY, EUR ve GBP olarak normalize edilir.

Pattern: ^(?:[A-Za-z]{3}|[Tt][Ll])$
Örnek:

"TRY"

bankCode
string
Required string length: 1 - 30
Örnek:

"00010"

direction
enum<string>
Mevcut seçenekler:
incoming,
outgoing
incoming
boolean

direction filtresinin boolean karşılığıdır. İkisi birlikte gönderilirse aynı yönü göstermelidir.

status
enum<integer>

0=pending, 1=processed, 2=ignored.

Mevcut seçenekler:
0,
1,
2
startDate

Dahil alt sınır. YYYY-MM-DD verilirse Europe/Istanbul gün başlangıcıdır. Geçerli YYYY-MM-DD tarihi veya saat ve Z/ofset içeren ISO-8601 zamanı.

Örnek:

"2026-09-01"

endDate

Dahil üst sınır. YYYY-MM-DD verilirse Europe/Istanbul gün sonudur. Geçerli YYYY-MM-DD tarihi veya saat ve Z/ofset içeren ISO-8601 zamanı.

Örnek:

"2026-09-01"

updatedSince

Bu UTC zamandan itibaren güncellenen hareketleri filtreler; dış sistemlerin artımlı REST eşitlemesi için kullanılır. Geçerli YYYY-MM-DD tarihi veya saat ve Z/ofset içeren ISO-8601 zamanı.

Örnek:

"2026-09-01"

Yanıt

Sayfalanmış hareket listesi

success
enum<boolean>
gerekli
Mevcut seçenekler:
true
meta
object
gerekli
data
object[]
gerekli