> 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/goto-checker-api-verificacao-em-lote.md).

# GoTo Checker API: Verificação em lote

GoTo Checker: Processe os valores de entrada pela API em lote e obtenha os campos de resultado listados abaixo.

## Formato de entrada

Envie um arquivo de texto com um número de telefone por linha. Normalize os valores antes do upload; o formato E.164 é recomendado para telefones.

```
+14155552671+442071838750
```

{% stepper %}
{% step %}

## Criar uma tarefa

`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="goto"'
```

A API retorna um ID de tarefa. Guarde esse ID e use-o para consultar o status.

### Resposta do upload

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

{% endstep %}

{% step %}

## Verificar status da tarefa

`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"'
```

Consulte até que `status` se torne `exported`. Não trate `pending` ou `processing` como resultado concluído.

### Resposta em processamento

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

### Resposta exportada

```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 %}

## Campos do resultado

| Campo       | Descrição                                                   | Exemplo      |
| ----------- | ----------------------------------------------------------- | ------------ |
| `number`    | Número de telefone do arquivo enviado.                      | +14155552671 |
| `activated` | Indica se a entrada foi detectada como ativa ou registrada. | yes          |

## Tratamento do arquivo de resultado

Baixe o arquivo por `result_url` somente após a tarefa ser exportada. Preserve os nomes das colunas retornados ao processar o arquivo.

## Campos da resposta

| Campo              | Descrição                                        |
| ------------------ | ------------------------------------------------ |
| `created_at`       | Data e hora de criação da tarefa.                |
| `updated_at`       | Data e hora da última atualização de status.     |
| `task_id`          | Identificador exclusivo da tarefa.               |
| `status`           | `pending`, `processing`, `exported` ou `failed`. |
| `total`            | Total de valores de entrada processados.         |
| `success`          | Valores processados com sucesso.                 |
| `failure`          | Valores cujo processamento falhou.               |
| `result_url`       | URL de download quando a tarefa é exportada.     |
| `actual_amount`    | Valor final liquidado, quando disponível.        |
| `estimated_amount` | Valor estimado retornado ao criar a tarefa.      |

## Códigos de status

| Status | Descrição                                                                   |
| ------ | --------------------------------------------------------------------------- |
| `200`  | Solicitação bem-sucedida.                                                   |
| `202`  | Tarefa criada com sucesso e cobrança estimada aplicada.                     |
| `400`  | Arquivo inválido, tipo de tarefa não compatível ou poucas entradas válidas. |
| `401`  | Chave de API ausente ou inválida.                                           |
| `402`  | Saldo insuficiente.                                                         |
| `404`  | Tarefa não encontrada.                                                      |
| `413`  | O arquivo enviado é grande demais.                                          |
| `500`  | Erro interno do servidor; tente novamente mais tarde.                       |

## Observações operacionais

* A tarefa é assíncrona; use o ID da tarefa para consultar o status.
* Verifique os limites de entrada do produto antes do upload.
* As linhas com falha aparecem no resultado exportado e são refletidas nos contadores.
* Os campos acima são baseados no sample atual e podem mudar quando o esquema de exportação upstream mudar.


---

# 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/goto-checker-api-verificacao-em-lote.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.