SendKuy API

Check which numbers are on WhatsApp

Asks WhatsApp, through one of your WhatsApp devices, whether each number has an account. Free: it spends no credit and does not count against your daily limit, but it has its own ceiling of 10 calls a minute per key. Answers are shared and kept for 30 days, so a number checked recently comes back without asking WhatsApp again. Only a WhatsApp device can check. A Cloud API number cannot.

Authorization

bearerAuth numbers:read
AuthorizationBearer <token>

Authorization: Bearer sk_live_.... Keys in the query string or the request body are refused — a URL is logged by every proxy it passes, and that is how customer keys leak.

A key carries scopes. A call outside them answers 403 with insufficient_scope and names the scope it wanted.

In: header

Scope: numbers:read

Header Parameters

Idempotency-Key?string

Any unique string, one per logical request. Retrying with the same key returns the first answer instead of doing the work twice, and answers with Idempotent-Replay: true. Server errors (5xx) and rate_limit_exceeded (429) are not remembered, because neither did any work; every other answer is, refusals included.

Lengthlength <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST https://app.sendkuy.com/api/v1/whatsapp/numbers/check \  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{  "numbers": [    "+6281234567890",    "+6281234567891"  ]}'
{  "data": [    {      "number": "+6281234567890",      "registered": true,      "checked_at": "2019-08-24T14:15:22Z"    }  ]}