List WhatsApp

Retrieve transactional WhatsApp messages sent by your organization, most recent first.

Endpoint

GET /whatsapp

Transactional only

Campaign sends are not included. This lists only messages sent through POST /whatsapp/send.

Query Parameters

Parameter	Type	Default	Description
limit	number	25	Items to return. Values above 100 are capped at 100.

Response

{
  "data": [
    {
      "id": "01957e3a-4b5c-7d8e-9f0a-1b2c3d4e5f6a",
      "to": "+966512345678",
      "templateName": "order_shipped",
      "language": "ar",
      "category": "UTILITY",
      "status": "delivered",
      "failureReason": null,
      "sentAt": "2026-03-08T12:00:03.000Z",
      "createdAt": "2026-03-08T12:00:00.000Z"
    }
  ]
}

Response Fields

Field	Description
id	Message ID
to	Recipient in E.164 format
templateName	The approved template that was sent
language	Template language code
category	MARKETING, UTILITY, or AUTHENTICATION
status	See Get WhatsApp
failureReason	Why the send failed. null unless status is failed.
sentAt	When the provider accepted the message. null while still queued.
createdAt	When the message was submitted to Arsel

Template parameters are never returned

parameters is deliberately absent from every response. For an authentication template that field holds the one-time code, and an endpoint that reads codes back out would turn a leaked API key into an account-takeover tool.

---

Examples

cURL

curl "https://api.arsel.sa/v1/whatsapp?limit=50" \
  -H "Authorization: Bearer be_your_api_key"

JavaScript

const response = await fetch("https://api.arsel.sa/v1/whatsapp?limit=50", {
  headers: { Authorization: "Bearer be_your_api_key" },
});

const { data } = await response.json();
console.log(data.length);

Python

import requests

response = requests.get(
    "https://api.arsel.sa/v1/whatsapp",
    headers={"Authorization": "Bearer be_your_api_key"},
    params={"limit": 50},
)

print(response.json()["data"])

C#

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer be_your_api_key");

var response = await client.GetAsync("https://api.arsel.sa/v1/whatsapp?limit=50");
Console.WriteLine(await response.Content.ReadAsStringAsync());

PHP

<?php
$ch = curl_init("https://api.arsel.sa/v1/whatsapp?limit=50");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer be_your_api_key"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
echo $response;
curl_close($ch);