Verify whether phone numbers are registered on WhatsApp using a connected session. Numbers must include the country code.

Use a connected WhatsApp session to query WhatsApp registration status. Dashboard routes require JWT (`contacts:read`). External routes require an API key with the `numbers:check` permission. Bulk checks accept up to 500 numbers.

When to use Number Check

Run a bulk check on imported lists before a campaign. Invalid rows are returned separately from registered / not-registered results. Saving a contact can also store WhatsApp status automatically when a session is connected.

POST/api/v1/number-check

Check single number

Check if one phone number is registered on WhatsApp.

URL: https://api.actiwapi.com/api/v1/number-check

Auth: JWT Bearer

Headers

Header	Value	Required
Authorization	Bearer {accessToken}	Yes
Content-Type	application/json	Yes*

Request example

{
  "sessionId": "uuid-of-connected-session",
  "phone": "+919876543210"
}

Code examples

curl -X POST "https://api.actiwapi.com/api/v1/number-check" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {accessToken}"
  -d '{  "sessionId": "uuid-of-connected-session",  "phone": "+919876543210"}'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/v1/number-check", {
    method: "POST",
    headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
    body: JSON.stringify({
  "sessionId": "uuid-of-connected-session",
  "phone": "+919876543210"
}),
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/v1/number-check", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
  body: JSON.stringify({
  "sessionId": "uuid-of-connected-session",
  "phone": "+919876543210"
}),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/v1/number-check",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer {accessToken}",
    },
    json={
  "sessionId": "uuid-of-connected-session",
  "phone": "+919876543210"
},
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/v1/number-check")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer {accessToken}"
request.body = "{  \"sessionId\": \"uuid-of-connected-session\",  \"phone\": \"+919876543210\"}"

response = http.request(request)
puts response.body

$ch = curl_init("https://api.actiwapi.com/api/v1/number-check");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "Authorization: Bearer {accessToken}"
    ],
    CURLOPT_POSTFIELDS => '{  "sessionId": "uuid-of-connected-session",  "phone": "+919876543210"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
    'Authorization' => 'Bearer {accessToken}',
];

$response = Http::withHeaders($headers)->post("https://api.actiwapi.com/api/v1/number-check", json_decode('{  "sessionId": "uuid-of-connected-session",  "phone": "+919876543210"}', true));

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");

var url = "https://api.actiwapi.com/api/v1/number-check";
var content = new StringContent("""
{  "sessionId": "uuid-of-connected-session",  "phone": "+919876543210"}
""", Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");
});

var app = builder.Build();

app.MapPost("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var content = new StringContent("""
{  "sessionId": "uuid-of-connected-session",  "phone": "+919876543210"}
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/v1/number-check")
    {
        Content = content,
    };
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{  "sessionId": "uuid-of-connected-session",  "phone": "+919876543210"}`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/v1/number-check", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Authorization", "Bearer {accessToken}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/v1/number-check"))
    .method("POST", HttpRequest.BodyPublishers.ofString("{  \"sessionId\": \"uuid-of-connected-session\",  \"phone\": \"+919876543210\"}"))
      .header("Content-Type", "application/json")
      .header("Authorization", "Bearer {accessToken}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example200

{
  "success": true,
  "data": {
    "sessionId": "uuid",
    "result": {
      "phone": "919876543210",
      "displayPhone": "+919876543210",
      "exists": true,
      "jid": "919876543210@s.whatsapp.net",
      "whatsappRegistered": true
    }
  }
}

Try in Swagger UI

POST/api/v1/number-check/bulk

Bulk check numbers

Check up to 500 numbers in one request. Use `phones` array or multiline `text`.

URL: https://api.actiwapi.com/api/v1/number-check/bulk

Auth: JWT Bearer

Headers

Header	Value	Required
Authorization	Bearer {accessToken}	Yes
Content-Type	application/json	Yes*

Request example

{
  "sessionId": "uuid-of-connected-session",
  "phones": ["+14155552671", "+919876543210"]
}

Code examples

curl -X POST "https://api.actiwapi.com/api/v1/number-check/bulk" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {accessToken}"
  -d '{  "sessionId": "uuid-of-connected-session",  "phones": ["+14155552671", "+919876543210"]}'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/v1/number-check/bulk", {
    method: "POST",
    headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
    body: JSON.stringify({
  "sessionId": "uuid-of-connected-session",
  "phones": ["+14155552671", "+919876543210"]
}),
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/v1/number-check/bulk", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
  body: JSON.stringify({
  "sessionId": "uuid-of-connected-session",
  "phones": ["+14155552671", "+919876543210"]
}),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/v1/number-check/bulk",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer {accessToken}",
    },
    json={
  "sessionId": "uuid-of-connected-session",
  "phones": ["+14155552671", "+919876543210"]
},
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/v1/number-check/bulk")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer {accessToken}"
request.body = "{  \"sessionId\": \"uuid-of-connected-session\",  \"phones\": [\"+14155552671\", \"+919876543210\"]}"

response = http.request(request)
puts response.body

$ch = curl_init("https://api.actiwapi.com/api/v1/number-check/bulk");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "Authorization: Bearer {accessToken}"
    ],
    CURLOPT_POSTFIELDS => '{  "sessionId": "uuid-of-connected-session",  "phones": ["+14155552671", "+919876543210"]}',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
    'Authorization' => 'Bearer {accessToken}',
];

$response = Http::withHeaders($headers)->post("https://api.actiwapi.com/api/v1/number-check/bulk", json_decode('{  "sessionId": "uuid-of-connected-session",  "phones": ["+14155552671", "+919876543210"]}', true));

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");

var url = "https://api.actiwapi.com/api/v1/number-check/bulk";
var content = new StringContent("""
{  "sessionId": "uuid-of-connected-session",  "phones": ["+14155552671", "+919876543210"]}
""", Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");
});

var app = builder.Build();

app.MapPost("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var content = new StringContent("""
{  "sessionId": "uuid-of-connected-session",  "phones": ["+14155552671", "+919876543210"]}
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/v1/number-check/bulk")
    {
        Content = content,
    };
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{  "sessionId": "uuid-of-connected-session",  "phones": ["+14155552671", "+919876543210"]}`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/v1/number-check/bulk", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Authorization", "Bearer {accessToken}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/v1/number-check/bulk"))
    .method("POST", HttpRequest.BodyPublishers.ofString("{  \"sessionId\": \"uuid-of-connected-session\",  \"phones\": [\"+14155552671\", \"+919876543210\"]}"))
      .header("Content-Type", "application/json")
      .header("Authorization", "Bearer {accessToken}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example200

{
  "success": true,
  "data": {
    "sessionId": "uuid",
    "summary": {
      "total": 2,
      "registered": 1,
      "notRegistered": 1,
      "invalid": 0,
      "truncated": 0
    },
    "results": [
      {
        "phone": "14155552671",
        "displayPhone": "+14155552671",
        "exists": true,
        "jid": "14155552671@s.whatsapp.net",
        "whatsappRegistered": true
      }
    ],
    "invalid": []
  }
}

Try in Swagger UI

POST/api/external/number-check

Check single number (API key)

Check one number via API key. Requires `numbers:check` permission.

URL: https://api.actiwapi.com/api/external/number-check

Auth: API Key

Headers

Header	Value	Required
X-API-Key	{apiKey}	Yes
Content-Type	application/json	Yes*

Request example

{
  "sessionId": "uuid-of-connected-session",
  "phone": "+919876543210"
}

Code examples

curl -X POST "https://api.actiwapi.com/api/external/number-check" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {apiKey}"
  -d '{  "sessionId": "uuid-of-connected-session",  "phone": "+919876543210"}'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/external/number-check", {
    method: "POST",
    headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
    body: JSON.stringify({
  "sessionId": "uuid-of-connected-session",
  "phone": "+919876543210"
}),
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/external/number-check", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
  body: JSON.stringify({
  "sessionId": "uuid-of-connected-session",
  "phone": "+919876543210"
}),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/external/number-check",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "{apiKey}",
    },
    json={
  "sessionId": "uuid-of-connected-session",
  "phone": "+919876543210"
},
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/external/number-check")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "application/json"
request["X-API-Key"] = "{apiKey}"
request.body = "{  \"sessionId\": \"uuid-of-connected-session\",  \"phone\": \"+919876543210\"}"

response = http.request(request)
puts response.body

$ch = curl_init("https://api.actiwapi.com/api/external/number-check");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: {apiKey}"
    ],
    CURLOPT_POSTFIELDS => '{  "sessionId": "uuid-of-connected-session",  "phone": "+919876543210"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
    'X-API-Key' => '{apiKey}',
];

$response = Http::withHeaders($headers)->post("https://api.actiwapi.com/api/external/number-check", json_decode('{  "sessionId": "uuid-of-connected-session",  "phone": "+919876543210"}', true));

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");

var url = "https://api.actiwapi.com/api/external/number-check";
var content = new StringContent("""
{  "sessionId": "uuid-of-connected-session",  "phone": "+919876543210"}
""", Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");
});

var app = builder.Build();

app.MapPost("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var content = new StringContent("""
{  "sessionId": "uuid-of-connected-session",  "phone": "+919876543210"}
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/external/number-check")
    {
        Content = content,
    };
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{  "sessionId": "uuid-of-connected-session",  "phone": "+919876543210"}`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/external/number-check", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("X-API-Key", "{apiKey}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/external/number-check"))
    .method("POST", HttpRequest.BodyPublishers.ofString("{  \"sessionId\": \"uuid-of-connected-session\",  \"phone\": \"+919876543210\"}"))
      .header("Content-Type", "application/json")
      .header("X-API-Key", "{apiKey}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example200

{
  "success": true,
  "data": {
    "sessionId": "uuid",
    "result": {
      "phone": "919876543210",
      "displayPhone": "+919876543210",
      "exists": true,
      "whatsappRegistered": true
    }
  }
}

Try in Swagger UI

POST/api/external/number-check/bulk

Bulk check numbers (API key)

Bulk number check via API key. Requires `numbers:check` permission.

URL: https://api.actiwapi.com/api/external/number-check/bulk

Auth: API Key

Headers

Header	Value	Required
X-API-Key	{apiKey}	Yes
Content-Type	application/json	Yes*

Request example

{
  "sessionId": "uuid-of-connected-session",
  "text": "+14155552671\n+919876543210"
}

Code examples

curl -X POST "https://api.actiwapi.com/api/external/number-check/bulk" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {apiKey}"
  -d '{  "sessionId": "uuid-of-connected-session",  "text": "+14155552671\n+919876543210"}'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/external/number-check/bulk", {
    method: "POST",
    headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
    body: JSON.stringify({
  "sessionId": "uuid-of-connected-session",
  "text": "+14155552671\n+919876543210"
}),
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/external/number-check/bulk", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
  body: JSON.stringify({
  "sessionId": "uuid-of-connected-session",
  "text": "+14155552671\n+919876543210"
}),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/external/number-check/bulk",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "{apiKey}",
    },
    json={
  "sessionId": "uuid-of-connected-session",
  "text": "+14155552671\n+919876543210"
},
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/external/number-check/bulk")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "application/json"
request["X-API-Key"] = "{apiKey}"
request.body = "{  \"sessionId\": \"uuid-of-connected-session\",  \"text\": \"+14155552671\\n+919876543210\"}"

response = http.request(request)
puts response.body

$ch = curl_init("https://api.actiwapi.com/api/external/number-check/bulk");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: {apiKey}"
    ],
    CURLOPT_POSTFIELDS => '{  "sessionId": "uuid-of-connected-session",  "text": "+14155552671\n+919876543210"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
    'X-API-Key' => '{apiKey}',
];

$response = Http::withHeaders($headers)->post("https://api.actiwapi.com/api/external/number-check/bulk", json_decode('{  "sessionId": "uuid-of-connected-session",  "text": "+14155552671\n+919876543210"}', true));

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");

var url = "https://api.actiwapi.com/api/external/number-check/bulk";
var content = new StringContent("""
{  "sessionId": "uuid-of-connected-session",  "text": "+14155552671\n+919876543210"}
""", Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");
});

var app = builder.Build();

app.MapPost("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var content = new StringContent("""
{  "sessionId": "uuid-of-connected-session",  "text": "+14155552671\n+919876543210"}
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/external/number-check/bulk")
    {
        Content = content,
    };
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{  "sessionId": "uuid-of-connected-session",  "text": "+14155552671\n+919876543210"}`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/external/number-check/bulk", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("X-API-Key", "{apiKey}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/external/number-check/bulk"))
    .method("POST", HttpRequest.BodyPublishers.ofString("{  \"sessionId\": \"uuid-of-connected-session\",  \"text\": \"+14155552671\n+919876543210\"}"))
      .header("Content-Type", "application/json")
      .header("X-API-Key", "{apiKey}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example200

{
  "success": true,
  "data": {
    "sessionId": "uuid",
    "summary": { "total": 2, "registered": 1, "notRegistered": 1, "invalid": 0 },
    "results": [],
    "invalid": []
  }
}

Try in Swagger UI

Error codes

Failed requests return a JSON envelope with success: false and a human-readable message.

{
  "success": false,
  "message": "Validation failed",
  "errors": {
    "phone": "Valid phone number is required"
  }
}

HTTP	Code	Description
400	VALIDATION_ERROR	Request body or query failed validation.
401	UNAUTHORIZED	Missing or invalid JWT / API key.
403	FORBIDDEN	Authenticated but lacking permission or entitlement.
403	SUBSCRIPTION_INACTIVE	Action not allowed on the current plan (including Free after trial). Upgrade or wait for entitlements.
403	LIMIT_EXCEEDED	Plan limit reached (sessions, messages, API requests, etc.).
404	NOT_FOUND	Resource does not exist or is not in your account.
409	CONFLICT	Duplicate resource or invalid state transition.
429	RATE_LIMITED	Too many requests; retry after backoff.
500	INTERNAL_ERROR	Unexpected server error.
502	WHATSAPP_UNAVAILABLE	WhatsApp session disconnected or provider error.