---
title: "Engellenmiş Numara Listesi API (get-blacklist)"
description: "Hesabınızdaki engellenmiş (kara liste) numaraları sayfalı şekilde alın. Tarih aralığı filtresi, 1000'lik sayfalama."
slug: /docs/api/get-blacklist
locale: tr
audience: developer
last_updated: 2026-04-29
endpoint:
  method: POST
  path: /v1/get-blacklist/json
  base_url: https://api.iletimerkezi.com
auth: api-key-and-hash
related: [add-blacklist, delete-blacklist, authentication, error-codes]
alternates:
  tr: https://www.iletimerkezi.com/docs/api/get-blacklist
  en: https://www.iletimerkezi.com/en/docs/api/get-blacklist
  toplusmsapi: https://toplusmsapi.com/numara-engelle/liste/json
  a2psmsapi: https://a2psmsapi.com/en/numara-engelle/liste/json
---

# Engellenmiş Numara Listesi API (get-blacklist)

`get-blacklist` endpoint'i, hesabınızdaki kara listeye eklenmiş numaraları döner. Mesaj göndermek istemediğiniz numaralar bu listeye eklenir; `send-sms` çağrılarında bu listedeki numaralara mesaj iletimi atlanır. Yan etkisiz, kontör harcamaz.

## Önemli ön koşul: Panel'de API erişimi

> Bu endpoint'i çağırmadan önce panelinizde **API kullanımına izin ver** seçeneğinin aktif olması gerekir.
>
> Ayar yeri: `panel.iletimerkezi.com` → **Ayarlar → Güvenlik → Erişim İzinleri**
>
> Aktif değilse istek `401 — Üyelik bilgileri hatalı` ile döner. Detay: [authentication.md](./authentication.md)

## Endpoint

| Alan | Değer |
|---|---|
| Method | `POST` |
| URL | `https://api.iletimerkezi.com/v1/get-blacklist/json` |
| Content-Type | `application/json` |
| Auth | API Key + Hash (`request.authentication`) |

## Request

### Şema

```
request
├─ authentication
│  ├─ key (string, zorunlu)
│  └─ hash (string, zorunlu)
└─ blacklist (opsiyonel — sayfalama ve filtre)
   ├─ filter (opsiyonel)
   │  ├─ start (string)    — "YYYY-MM-DD HH:MM:SS"
   │  └─ end (string)      — "YYYY-MM-DD HH:MM:SS"
   ├─ page (string)        — varsayılan "1"
   └─ rowCount (string)    — varsayılan "1000", maks "1000"
```

### Tam örnek

Filtresiz, ilk sayfa:

```json
{
  "request": {
    "authentication": {
      "key": "API_KEY",
      "hash": "API_HASH"
    }
  }
}
```

Tarih filtresiyle:

```json
{
  "request": {
    "authentication": {
      "key": "API_KEY",
      "hash": "API_HASH"
    },
    "blacklist": {
      "filter": {
        "start": "2026-04-01 00:00:00",
        "end": "2026-04-30 23:59:59"
      },
      "page": "1",
      "rowCount": "100"
    }
  }
}
```

## Response

### Başarılı (200)

```json
{
  "response": {
    "status": {
      "code": 200,
      "message": "İşlem başarılı"
    },
    "blacklist": {
      "count": 1,
      "number": [
        "+905330000099"
      ]
    }
  }
}
```

**Alanlar:**

- `response.blacklist.count` (integer): Hesaptaki toplam engellenmiş numara sayısı (sayfalamadan bağımsız, genel toplam).
- `response.blacklist.number` (string[]): Bu sayfadaki engellenmiş numaralar. Yanıtta numaralar `+90` prefix'i ile gelir (gönderirken `905XXXXXXXXX` ya da `+905XXXXXXXXX` ikisi de kabul edilir).

### Boş liste (200)

```json
{
  "response": {
    "status": { "code": 200, "message": "İşlem başarılı" },
    "blacklist": { "count": 0, "number": [] }
  }
}
```

### Hata yanıtları

#### 401 — Üyelik bilgileri hatalı

API Anahtar/Hash doğrulanamadı veya panel toggle kapalı. Detay: [authentication.md](./authentication.md).

#### Diğer hata kodları

`400, 404` için tablo: [error-codes.md](./error-codes.md).

## Kod örnekleri

### cURL

```bash
curl -X POST 'https://api.iletimerkezi.com/v1/get-blacklist/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "request": {
      "authentication": {
        "key": "'"$ILETIMERKEZI_API_KEY"'",
        "hash": "'"$ILETIMERKEZI_API_HASH"'"
      }
    }
  }'
```


## Common Pitfalls

- **Numara format dönüşte değişir.** Eklerken `905XXXXXXXXX` versen bile yanıt `+905XXXXXXXXX` döner. Karşılaştırma yapan kodlarda iki formatı da normalize edin.
- **Sayfalama 1000'le sınırlı.** `rowCount` üst sınır 1000. 1000'den fazla kayıt için `page` arttırarak ardışık çağrı yapın; toplam adedi `count` alanı verir.
- **`count` sayfalamadan bağımsız.** Sayfada kaç kayıt görüldüğüne bakmaksızın hesaptaki toplam engellenmiş numarayı verir; pagination loop kontrolü için bu kullanılır.
- **`get-blacklist` kontör harcamaz.** Cache'lemek pratik bir kullanım deseni; her `send-sms` öncesi çağırmaya gerek yok.


## Related

- [Numara engelle (add-blacklist)](./add-blacklist.md)
- [Engelleme kaldır (delete-blacklist)](./delete-blacklist.md)
- [Kimlik doğrulama (authentication)](./authentication.md)
- [Hata kodları tablosu](./error-codes.md)