> For the complete documentation index, see [llms.txt](https://docs.geeknums.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geeknums.io/botim-numara-kontrol-apisi.md).

# Botim Numara Kontrol API'si

Botim kayıtlarını toplu olarak kontrol edin ve dışa aktarılan sonuçları indirin.

## Ürün parametreleri

| Parametre             | Değer                            |
| --------------------- | -------------------------------- |
| Görev türü            | `botim`                          |
| Girdi türü            | E.164 biçiminde telefon numarası |
| Minimum geçerli kayıt | 500                              |

{% hint style="info" %}
`estimated_amount` hesap fiyatına göre hesaplanır ve görev için geçerli tahmini tutardır.
{% endhint %}

## Girdi biçimi

Her satırda bir numara bulunan `.txt` veya `.csv` dosyası yükleyin. E.164 önerilir.

```
+14155552671+442071838750
```

{% stepper %}
{% step %}

## Görev oluştur

`POST https://api.checknumber.ai/v1/tasks`

```bash
curl --location 'https://api.checknumber.ai/v1/tasks' \--header 'X-API-Key: YOUR_API_KEY' \--form 'file=@"./numbers.txt"' \--form 'task_type="botim"'
```

API bir görev kimliği döndürür. Durum sorgusu için saklayın.
{% endstep %}

{% step %}

## Görev durumunu sorgula

`POST https://api.checknumber.ai/v1/gettasks`

```bash
curl --location 'https://api.checknumber.ai/v1/gettasks' \--header 'X-API-Key: YOUR_API_KEY' \--form 'task_id="d4g8o46p2jvh04o9uolg"'
```

`status` değeri `exported` olana kadar sorgulayın. `pending` ve `processing` tamamlanmış değildir.
{% endstep %}
{% endstepper %}

## Yükleme yanıtı

```json
{  "task_id": "d4g8o46p2jvh04o9uolg",  "status": "pending",  "total": 500,  "estimated_amount": {    "amount": "0.250000",    "currency": "USD"  },  "message": "Task created successfully"}
```

## İşleme yanıtı

```json
{  "task_id": "d4g8o46p2jvh04o9uolg",  "status": "processing",  "total": 500,  "success": 250,  "failure": 0}
```

## Dışa aktarma yanıtı

```json
{  "task_id": "d4g8o46p2jvh04o9uolg",  "status": "exported",  "total": 500,  "success": 500,  "failure": 0,  "result_url": "https://example-link-to-results.zip",  "actual_amount": {    "amount": "0.250000",    "currency": "USD"  }}
```

## Sonuç alanları

| Alan                | Açıklama                                              | Örnek        |
| ------------------- | ----------------------------------------------------- | ------------ |
| `number` / `Number` | Girdi numarası. CSV `number`, XLSX `Number` kullanır. | +14155552671 |
| `activated`         | Numara için hesap algılanıp algılanmadığı.            | yes / no     |

{% hint style="info" %}
Hesap bulunmayan satırlar `activated=no` döndürür; profil verisi yoksa alanlar boştur.
{% endhint %}

## Sonuç dosyasını işleme

Paketi yalnızca dışa aktarıldıktan sonra `result_url` üzerinden indirin ve sütun adlarını koruyun.

## Yanıt alanları

| Alan               | Açıklama                                           |
| ------------------ | -------------------------------------------------- |
| `created_at`       | Oluşturma zamanı.                                  |
| `updated_at`       | Son güncelleme zamanı.                             |
| `task_id`          | Benzersiz görev kimliği.                           |
| `status`           | `pending`, `processing`, `exported` veya `failed`. |
| `total`            | Toplam geçerli girdi.                              |
| `success`          | Başarıyla işlenen değerler.                        |
| `failure`          | Başarısız değerler.                                |
| `result_url`       | Dışa aktarma sonrası indirme URL’si.               |
| `actual_amount`    | Varsa nihai tutar.                                 |
| `estimated_amount` | Oluşturmadaki tahmini tutar.                       |

## Durum kodları

| Durum | Açıklama                                                |
| ----- | ------------------------------------------------------- |
| `200` | İstek başarılı.                                         |
| `202` | Görev oluşturuldu ve tahmini ücret uygulandı.           |
| `400` | Geçersiz dosya, desteklenmeyen tür veya yetersiz kayıt. |
| `401` | API Key eksik veya geçersiz.                            |
| `402` | Yetersiz bakiye.                                        |
| `404` | Görev bulunamadı.                                       |
| `413` | Dosya çok büyük.                                        |
| `500` | İç hata; daha sonra tekrar deneyin.                     |

## Operasyon notları

* Görev asenkrondur; dönen kimlikle sorgulayın.
* Yalnızca geçerli ve normalize edilmiş numaralar minimuma sayılır.
* Başarısız görevler faturalandırma akışına göre otomatik iade edilir.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.geeknums.io/botim-numara-kontrol-apisi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.