Realizar pedidos

1. Elige un verificadorCopy Anchor Link

GET /checkers muestra lo que tu cuenta puede pedir, a tus precios. Cada uno tiene un id, como whatsapp_status_detection, y acepta teléfonos, correos o nombres de usuario. Consulta Verificadores.

curl "https://api.talismanleads.io/v1/checkers" \
  -H "Authorization: Bearer tl_live_your_key_here"

2. Envía tu listaCopy Anchor Link

Pon hasta 100.000 entradas y 4 MB en la solicitud como entries. Para una lista mayor, pide un enlace a POST /uploads, envía el archivo a ese enlace con PUT y luego usa su upload_id. El enlace dura 2 horas. No envíes tu clave de API a ese enlace.

• Un archivo es un .txt con una entrada por línea, de hasta 200 MB y 10.000.000 de entradas.
• Escribe los números de teléfono con su código de país, como +14155550142.
• Los números de teléfono de un archivo deberían ser de un solo país: al menos el 90 % de ellos. Divide una lista mixta en un archivo por país.
• Una sola línea no válida hace que se rechace toda la lista, y la respuesta muestra ejemplos.
• Un archivo subido espera un pedido durante 24 horas y después se elimina.
• Puedes tener 20 archivos o 100 MB en espera a la vez, sea cual sea el número de claves de API que uses, y hacer 500 subidas al día. Si estás por debajo de esos límites, puedes añadir además un archivo de cualquier tamaño permitido.

Pide un enlace

curl -X POST "https://api.talismanleads.io/v1/uploads" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_name":"list.txt","size_bytes":1048576}'

Envía el archivo a ese enlace

UPLOAD_URL="PASTE_upload_url_FROM_THE_ANSWER_ABOVE"
curl --upload-file list.txt "$UPLOAD_URL" \
  -H "Content-Type: text/plain" \
  -w "%{http_code}\n"

3. Consulta el precioCopy Anchor Link

POST /estimates cuenta las entradas y calcula el precio, y no cobra nada. billed_entries puede ser mayor que entries, porque cada archivo se factura como al menos 2.000.

curl -X POST "https://api.talismanleads.io/v1/estimates" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'

4. Realiza el pedidoCopy Anchor Link

POST /orders cobra de tu saldo y pone el trabajo en cola. Envía una Idempotency-Key, para que un reintento no pueda cobrarte dos veces: consulta Reintentos seguros. Para asegurarte del precio, envía expected_charge, y el pedido se rechaza con price_changed si cuesta cualquier otra cantidad. Espera hasta 5 minutos la respuesta, porque leer una lista grande lleva tiempo.

curl -X POST "https://api.talismanleads.io/v1/orders" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Idempotency-Key: crm-export-2026-11-05" \
  -H "Content-Type: application/json" \
  -d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'

5. Sigue su estadoCopy Anchor Link

Consulta GET /orders/{id} dejando 30 segundos o más entre consultas. Un archivo grande se divide internamente en partes, pero un pedido tiene un solo estado y un solo total.

queued

En espera de empezar.

processing

En ejecución.

completed

Terminado, con todas las partes hechas.

partially_completed

Terminado, con algunas partes fallidas. Esas partes se reembolsan: `refunded` muestra lo que se devolvió.

failed

No se pudo hacer ninguna parte. El cargo se reembolsa: `refunded` muestra lo que se devolvió.

Pueden añadirse más estados, así que trata uno que no conozcas como si siguiera en ejecución.

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
  -H "Authorization: Bearer tl_live_your_key_here"

6. Obtén el resultadoCopy Anchor Link

GET /orders/{id}/results da un enlace de descarga por cada parte, válido durante 15 minutos. Pide un enlace nuevo cuando quieras: los resultados se conservan. Un archivo suele ser un zip con all.csv, una hoja de cálculo y listas de texto, o un único CSV. Pueden añadirse columnas, así que léelas por nombre y no por posición. No envíes tu clave de API a estos enlaces.

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
  -H "Authorization: Bearer tl_live_your_key_here"

Cargos y reembolsosCopy Anchor Link

charge es lo que costó el pedido cuando lo realizaste, y refunded es la cantidad que se te devolvió. Una parte que falla se reembolsa por completo, y si el proveedor contó de menos en una parte, se devuelve la diferencia, hasta llegar al mínimo por el que se factura esa parte. Ambas cosas ocurren automáticamente.

La misma lista en el mismo verificador en aproximadamente un día, con una clave de idempotencia nueva, se cobra otra vez como un pedido nuevo, y puede devolver tu resultado anterior en lugar de una verificación nueva.

Pedidos de otros canalesCopy Anchor Link

Los pedidos que realizas en el sitio web también aparecen en la lista. Los pedidos de la API aparecen en Mis tareas, en el sitio web, con una insignia de API, y no envían nada a Telegram a menos que lo pidas allí.