Bestellingen plaatsen

1. Kies een checkerCopy Anchor Link

GET /checkers toont wat je account kan bestellen, tegen jouw prijzen. Elke checker heeft een id, zoals whatsapp_status_detection, en accepteert telefoonnummers, e-mails of gebruikersnamen. Zie Checkers.

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

2. Stuur je lijstCopy Anchor Link

Zet maximaal 100.000 items en 4 MB in het verzoek als entries. Vraag voor een grotere lijst een link aan bij POST /uploads, stuur het bestand met PUT naar die link en gebruik daarna de bijbehorende upload_id. De link blijft 2 uur geldig. Stuur je API-sleutel niet naar die link.

• Een bestand is een .txt met één item per regel, tot 200 MB en 10.000.000 items.
• Schrijf telefoonnummers met hun landcode, zoals +14155550142.
• Telefoonnummers in één bestand horen uit één land te komen: minstens 90% ervan. Splits een gemengde lijst in één bestand per land.
• Eén ongeldige regel zorgt ervoor dat de hele lijst wordt geweigerd, en het antwoord toont voorbeelden.
• Een geüpload bestand wacht 24 uur op een bestelling en wordt daarna verwijderd.
• Je kunt tegelijk 20 bestanden of 100 MB laten wachten, ongeacht hoeveel API-sleutels je gebruikt, en 500 uploads per dag doen. Eén bestand van elke toegestane grootte kan daar nog bovenop komen als je onder die limieten zit.

Vraag een link aan

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}'

Stuur het bestand naar die link

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. Bekijk de prijsCopy Anchor Link

POST /estimates telt de items en berekent de prijs, en schrijft niets af. billed_entries kan hoger zijn dan entries, omdat elk bestand wordt gefactureerd als minstens 2.000 items.

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. Plaats de bestellingCopy Anchor Link

POST /orders schrijft het bedrag af van je saldo en zet het werk in de wachtrij. Stuur een Idempotency-Key mee, zodat een nieuwe poging je niet twee keer kan laten betalen: zie Veilig opnieuw proberen. Om zeker te zijn van de prijs stuur je expected_charge mee, dan wordt de bestelling geweigerd met price_changed als die iets anders kost. Reken op maximaal 5 minuten voor het antwoord, omdat een grote lijst inlezen tijd kost.

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. Volg de statusCopy Anchor Link

Vraag GET /orders/{id} op met 30 seconden of meer ertussen. Een groot bestand wordt achter de schermen in delen gesplitst, maar een bestelling heeft één status en één totaal.

queued

Wacht om te starten.

processing

Wordt uitgevoerd.

completed

Klaar, met alle delen voltooid.

partially_completed

Klaar, met enkele mislukte delen. Die delen worden terugbetaald: `refunded` toont wat er is teruggekomen.

failed

Geen enkel deel kon worden uitgevoerd. De afschrijving wordt terugbetaald: `refunded` toont wat er is teruggekomen.

Er kunnen statussen bijkomen, dus behandel een status die je niet kent als nog lopend.

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

6. Haal het resultaat opCopy Anchor Link

GET /orders/{id}/results geeft een downloadlink per deel, 15 minuten geldig. Vraag op elk moment een nieuwe link aan: resultaten blijven bewaard. Een bestand is meestal een zip met all.csv, een spreadsheet en tekstlijsten, of één CSV. Er kunnen kolommen bijkomen, dus lees ze op naam en niet op positie. Stuur je API-sleutel niet naar deze links.

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

Afschrijvingen en terugbetalingenCopy Anchor Link

charge is wat de bestelling kostte toen je hem plaatste, en refunded is hoeveel daarvan is teruggekomen. Een deel dat mislukt, wordt volledig terugbetaald, en bij een deel waarvan de provider minder telde, wordt het verschil teruggegeven, tot aan het minimum waarvoor dat deel wordt gefactureerd. Beide gebeuren automatisch.

Dezelfde lijst op dezelfde checker binnen ongeveer een dag, met een nieuwe idempotentiesleutel, wordt opnieuw afgeschreven als een nieuwe bestelling en kan je eerdere resultaat teruggeven in plaats van een nieuwe controle.

Bestellingen van eldersCopy Anchor Link

Bestellingen die je op de website plaatst, staan er ook bij. API-bestellingen verschijnen in Mijn taken op de website met een API-badge, en sturen niets naar Telegram tenzij je daar om vraagt.