> ## Documentation Index
> Fetch the complete documentation index at: https://docs.banka.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Sayfalama ve filtreler

> Liste uçlarında sayfa gezme, sıralama, filtreleme ve arama.

## Sayfalama

Liste uçları `page` ve `pageSize` parametrelerini kabul eder.

| Uç | Varsayılan `pageSize` | En çok |
| - | - | - |
| `GET /v1/bank-transactions` | 25 | 100 |
| `GET /v1/bank-accounts` | 25 | 500 |
| `GET /v1/bank-accounts/{id}/balance-history` | 25 | 500 |

`page` 1'den başlar. Yanıtın `meta` alanı toplam kayıt ve sayfa sayısını verir:

```json theme={null}
"meta": { "page": 2, "pageSize": 100, "total": 1340, "totalPages": 14 }
```

Bütün sayfaları gezmek için `page` değerini `totalPages`'e ulaşana kadar artırın.

## Sıralama

Hareketler her zaman en yeniden eskiye döner: önce `transactionDate`, eşitlikte hareket kimliği azalan sırada. Sıralama parametresi yoktur.

## Filtreler

Filtreler doğrudan sorgu parametresi olarak ya da `filter[...]` biçiminde gönderilebilir; iki yazım aynı sonucu verir.

```bash theme={null}
# İkisi de aynı
curl "https://api.banka.pro/v1/bank-transactions?currency=USD&direction=incoming" -u "$KEY:$SECRET"
curl "https://api.banka.pro/v1/bank-transactions?filter[currency]=USD&filter[direction]=incoming" -u "$KEY:$SECRET"
```

### Hareket filtreleri

| Parametre | Açıklama |
| - | - |
| `accountId` | Tek banka hesabının hareketleri |
| `currency` | Para birimi (`TRY` filtresi para birimi boş kayıtları da kapsar) |
| `bankCode` | Banka kodu |
| `direction` | `incoming` veya `outgoing` |
| `incoming` | `direction` filtresinin `true`/`false` karşılığı; ikisi birlikte gönderilirse aynı yönü göstermelidir |
| `status` | `0` bekliyor, `1` işlendi, `2` yok sayıldı |
| `startDate`, `endDate` | Hareket tarihi aralığı, sınırlar dahil. Bkz. [Zaman](/veri-kurallari#zaman) |
| `updatedSince` | Bu andan sonra güncellenen hareketler. Bkz. [Artımlı eşitleme](/artimli-esitleme) |
| `q` | Metin araması (aşağıda) |

`GET /v1/bank-transactions/summary` sayfalama dışında aynı filtreleri kabul eder ve gelen, giden ve net tutarı para birimi bazında döner.

### Hesap filtreleri

| Parametre | Açıklama |
| - | - |
| `currency` | Para birimi |
| `bankCode` | Banka kodu |
| `archived` | `true` arşivlenmiş hesapları getirir; gönderilmezse arşivlenmemiş hesaplar listelenir |
| `isApi` | Hesabın `isApi` değerine göre süzer (`true` / `false`) |
| `q` | Metin araması (aşağıda) |

## Arama (`q`)

`q` 2–100 karakterdir; büyük/küçük harf ve Türkçe karakter farkını gözetmez.

* **Hesaplarda** hesap adı, banka adı ve kodu, hesap kodu ve IBAN aranır.
* **Hareketlerde** karşı taraf adında ve açıklamanın kelimelerinde aranır. Açıklamada en az 3 harfli kelimeler eşleşir.
* Anahtarda **Kişisel veriler** (`baPii`) yetkisi varsa karşı taraf IBAN'ı ve TCKN/VKN'si de aranır. IBAN veya 10–11 haneli kimlik numarası niteliğindeki bir arama bu yetki yoksa `403 FORBIDDEN` döner.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.