WhatsApp Aktivitätsprüfer API: Kontoaktivität ermitteln

Ermittelt für die eingegebenen internationalen Telefonnummern die Aktivitätsdauer von WhatsApp-Konten, ob es sich um Geschäftskonten handelt, sowie Signaturinformationen.

Codebeispiel zum Hochladen der Prüfdatei:

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./number.txt"' \
--form 'task_type="ws_active"'

Codebeispiel zum Prüfen des Aufgabenstatus:

curl --location 'https://api.numberchecker.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

Antwort nach erfolgreichem Hochladen der Prüfdatei

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Antwort waehrend der Verarbeitung

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Antwort nach Abschluss der Aufgabe einschließlich Download-URL für die Ergebnisse.

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256..."
}

Anfrage-URL zum Hochladen der Datei

POST https://api.numberchecker.ai/v1/tasks

Anfrageparameter zum Hochladen der Datei

Parameter	Beschreibung
`file`	`file`, Hochzuladende Datei; jede Zeile muss eine Telefonnummer im E.164-Format enthalten
`task_type`	`string`, Aufgabentyp; setzen Sie ihn auf “ws_active”

Anfrage-URL zum Prüfen des Aufgabenstatus

POST https://api.numberchecker.ai/v1/gettasks

Anfrageparameter zum Prüfen des Aufgabenstatus

Parameter	Beschreibung
`task_id`	`string`, Aufgaben-ID aus der Aufgabenerstellung

Ergebnisfelder

Feld	Beschreibung	Beispiel
`Number`	Telefonnummer im E.164-Format	+12025551234
`whatsapp_days`	Tage der WhatsApp-Kontoaktivitaet	1, 7, 30, N/A
`whatsapp_business`	Ob die Nummer ein aktives WhatsApp Business-Konto hat	yes, no
`signature`	Signaturinformationen des WhatsApp-Kontos	Hello World, N/A

Antwortformat

Feld	Beschreibung
`created_at`	Zeitstempel der Aufgabenerstellung
`updated_at`	Zeitstempel der letzten Statusaktualisierung
`task_id`	Eindeutige Aufgabenkennung
`user_id`	Benutzer-ID
`status`	Aufgabenstatus: `pending`: In Warteschlange `processing`: Wird verarbeitet `exported`: Ergebnisse stehen zum Download bereit
`total`	Insgesamt verarbeitete Telefonnummern
`success`	Erfolgreich identifizierte Nummern
`failure`	Nummern mit fehlgeschlagener Verarbeitung
`result_url`	(Optional) Download-URL für Ergebnisse bei Status `exported`

Statuscodes

Status	Beschreibung
`200`	`charge`, Anfrage erfolgreich; Aufgabe erstellt oder Status abgerufen
`400`	`free`, Ungültige Anfrage: Parameter oder Dateiformat fehlerhaft
`500`	`free`, Interner Serverfehler; bitte später erneut versuchen