Items

curl --request GET \
  --url 'https://api.mailersend.com/v1/whatsapp/items?recipient=48600000002&status[]=failed&date_from=2026-10-14T00:00:00Z&date_to=2026-10-15T00:00:00Z&limit=25' \
  --globoff \
  --header 'Authorization: Bearer API_KEY_HERE'

use MailerSend\MailerSend;
use MailerSend\Helpers\Builder\WhatsappItemParams;

$mailersend = new MailerSend(['api_key' => 'key']);

$whatsappItemParams = (new WhatsappItemParams())
    ->setRecipient('48600000002')
    ->setStatus(['failed'])
    ->setDateFrom('2026-10-14T00:00:00Z')
    ->setDateTo('2026-10-15T00:00:00Z')
    ->setPage(1)
    ->setLimit(25);

$whatsappItems = $mailersend->whatsappItem->getAll($whatsappItemParams);

import 'dotenv/config';
import { MailerSend } from "mailersend";

const mailerSend = new MailerSend({
  apiKey: process.env.API_KEY,
});

mailerSend.whatsapp.item.list({
  recipient: "48600000002",
  status: ["failed"],
  date_from: 1791936000,
  date_to: 1792022400,
  limit: 25,
  page: 1,
})
  .then((response) => console.log(response.body))
  .catch((error) => console.log(error.body));

from mailersend import MailerSendClient, WhatsAppItemsBuilder
from mailersend.models.whatsapp_items import WhatsAppItemStatus

ms = MailerSendClient()

request = (WhatsAppItemsBuilder()
          .recipient("48600000002")
          .status([WhatsAppItemStatus.FAILED])
          .date_from("2026-10-14T00:00:00Z")
          .date_to("2026-10-15T00:00:00Z")
          .page(1)
          .limit(25)
          .build_list_request())

response = ms.whatsapp_items.list_whatsapp_items(request)

package main

import (
	"context"
	"log"
	"time"

	"github.com/mailersend/mailersend-go"
)

var APIKey = "Api Key Here"

func main() {
	// Create an instance of the mailersend client
	ms := mailersend.NewMailersend(APIKey)

	ctx := context.Background()
	ctx, cancel := context.WithTimeout(ctx, 5*time.Second)
	defer cancel()

	options := &mailersend.ListWhatsAppItemOptions{
		Recipient: "48600000002",
		Status:    []string{"failed"},
		DateFrom:  1791936000,
		DateTo:    1792022400,
		Page:      1,
		Limit:     25,
	}

	_, _, err := ms.WhatsAppItem.List(ctx, options)
	if err != nil {
		log.Fatal(err)
	}
}

import com.mailersend.sdk.MailerSend;
import com.mailersend.sdk.exceptions.MailerSendException;
import com.mailersend.sdk.whatsapp.items.WhatsAppItem;
import com.mailersend.sdk.whatsapp.items.WhatsAppItemList;

public void getWhatsAppItems() {

    MailerSend ms = new MailerSend();
    ms.setToken("mailersend token");

    try {

        WhatsAppItemList list = ms.whatsapp().items()
            .recipient("48600000002")
            .addStatusFilter("failed")
            .dateFrom(1791936000)
            .dateTo(1792022400)
            .page(1)
            .limit(25)
            .getItems();

        for (WhatsAppItem item : list.items) {
            System.out.println(item.id);
            System.out.println(item.status);
            System.out.println(item.errorCode);
        }

    } catch (MailerSendException e) {

        e.printStackTrace();
    }
}

require "mailersend-ruby"

# Intialize the WhatsApp Items class
ms_whatsapp_items = Mailersend::WhatsAppItems.new

# Add parameters
ms_whatsapp_items.list(
  recipient: '48600000002',
  status: %w[failed],
  date_from: 1791936000,
  date_to: 1792022400,
  page: 1,
  limit: 25
)

curl --request GET \
  --url https://api.mailersend.com/v1/whatsapp/items/67f91abe2202f3705540234a \
  --header 'Authorization: Bearer API_KEY_HERE'

use MailerSend\MailerSend;

$mailersend = new MailerSend(['api_key' => 'key']);

$whatsappItem = $mailersend->whatsappItem->find('item_id');

import 'dotenv/config';
import { MailerSend } from "mailersend";

const mailerSend = new MailerSend({
  apiKey: process.env.API_KEY,
});

mailerSend.whatsapp.item.single("item_id")
  .then((response) => console.log(response.body))
  .catch((error) => console.log(error.body));

from mailersend import MailerSendClient, WhatsAppItemsBuilder

ms = MailerSendClient()

request = (WhatsAppItemsBuilder()
          .whatsapp_item_id("item-id")
          .build_get_request())

response = ms.whatsapp_items.get_whatsapp_item(request)

package main

import (
	"context"
	"log"
	"time"

	"github.com/mailersend/mailersend-go"
)

var APIKey = "Api Key Here"

func main() {
	// Create an instance of the mailersend client
	ms := mailersend.NewMailersend(APIKey)

	ctx := context.Background()
	ctx, cancel := context.WithTimeout(ctx, 5*time.Second)
	defer cancel()

	_, _, err := ms.WhatsAppItem.Get(ctx, "item-id")
	if err != nil {
		log.Fatal(err)
	}
}

import com.mailersend.sdk.MailerSend;
import com.mailersend.sdk.exceptions.MailerSendException;
import com.mailersend.sdk.whatsapp.items.WhatsAppItem;

public void getWhatsAppItem() {

    MailerSend ms = new MailerSend();
    ms.setToken("mailersend token");

    try {

        WhatsAppItem item = ms.whatsapp().items().getItem("item id");

        System.out.println(item.id);
        System.out.println(item.status);

    } catch (MailerSendException e) {

        e.printStackTrace();
    }
}

require "mailersend-ruby"

# Intialize the WhatsApp Items class
ms_whatsapp_items = Mailersend::WhatsAppItems.new

# Add parameters
ms_whatsapp_items.get(whatsapp_item_id: 'your-whatsapp-item-id')