> 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/htx-bulk-number-checker-api-toplu-kontrol.md).

# HTX Bulk Number Checker API: Toplu kontrol

HTX Bulk Number Checker: Giriş değerlerini toplu API ile işleyin ve aşağıda listelenen sonuç alanlarını alın.

## Girdi biçimi

Her satırda bir telefon numarası bulunan bir metin dosyası yükleyin. Yüklemeden önce değerleri normalleştirin; telefonlar için E.164 biçimi önerilir.

```
+14155552671+442071838750
```

{% stepper %}
{% step %}

## Görev oluşturma

`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=@"./input.txt"' \--form 'task_type="htx"'
```

API bir görev kimliği döndürür. Bu kimliği saklayın ve görev durumunu sorgulamak için kullanın.

### Yükleme yanıtı

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

{% endstep %}

{% step %}

## Görev durumunu kontrol etme

`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ış sonuç değildir.

### İşleme yanıtı

```json
{  "task_id": "d4g8o46p2jvh04o9uolg",  "status": "processing",  "total": 5000,  "success": 2500,  "failure": 0}
```

### Dışa aktarılan yanıt

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

{% endstep %}
{% endstepper %}

## Sonuç alanları

| Alan        | Açıklama                                                    | Örnek        |
| ----------- | ----------------------------------------------------------- | ------------ |
| `number`    | Gönderilen dosyadaki giriş telefon numarası.                | +14155552671 |
| `activated` | Girdinin etkin veya kayıtlı olarak algılanıp algılanmadığı. | yes          |

## Sonuç dosyası işlemleri

Dosyayı `result_url` üzerinden yalnızca görev dışa aktarıldıktan sonra indirin. Dosyayı işlerken döndürülen sütun adlarını koruyun.

## Yanıt alanları

| Alan               | Açıklama                                           |
| ------------------ | -------------------------------------------------- |
| `created_at`       | Görevin oluşturulduğu zaman.                       |
| `updated_at`       | Son görev durumu güncellemesinin zamanı.           |
| `task_id`          | Benzersiz görev tanımlayıcısı.                     |
| `status`           | `pending`, `processing`, `exported` veya `failed`. |
| `total`            | İşlenen toplam giriş değeri.                       |
| `success`          | Başarıyla işlenen değerler.                        |
| `failure`          | İşlenemeyen değerler.                              |
| `result_url`       | Görev dışa aktarıldığında indirme URL’si.          |
| `actual_amount`    | Varsa kesinleşen tutar.                            |
| `estimated_amount` | Görev oluşturulurken döndürülen tahmini tutar.     |

## Durum kodları

| Status | Açıklama                                                             |
| ------ | -------------------------------------------------------------------- |
| `200`  | İstek başarılı.                                                      |
| `202`  | Görev başarıyla oluşturuldu ve tahmini ücret uygulandı.              |
| `400`  | Geçersiz dosya, desteklenmeyen görev türü veya çok az geçerli giriş. |
| `401`  | API anahtarı eksik veya geçersiz.                                    |
| `402`  | Yetersiz hesap bakiyesi.                                             |
| `404`  | Görev bulunamadı.                                                    |
| `413`  | Yüklenen dosya çok büyük.                                            |
| `500`  | Dahili sunucu hatası; daha sonra tekrar deneyin.                     |

## Operasyon notları

* Görev eşzamansızdır; durumu sorgulamak için görev kimliğini kullanın.
* Yüklemeden önce ürüne özel giriş sınırlarını kontrol edin.
* Başarısız satırlar dışa aktarılan sonuçta raporlanır ve görev sayaçlarına yansıtılır.
* Yukarıdaki alanlar mevcut canlı sample temelindedir ve dışa aktarma şeması değişirse değişebilir.


---

# 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/htx-bulk-number-checker-api-toplu-kontrol.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.