Liste des contacts

GEThttps://app.sendapp.ai/api/contacts

Récupère la liste paginée de vos contacts, avec des filtres de recherche et de tag. Utile aussi pour trouver les ID à utiliser lors de la suppression. L'authentification peut passer par l'en-tête X-API-Key ou par le champ apikey.

Paramètres

apikey obligatoire

La tua API Key (anche header X-API-Key).

page facultatif

Numéro de page (par défaut 1).

per_page facultatif

Éléments par page (par défaut 100, max 1000).

search facultatif

Recherche par nom, téléphone ou e-mail (LIKE).

tag facultatif

Correspondance exacte du tag.

with_phone facultatif

Uniquement les contacts avec un numéro de téléphone.

with_email facultatif

Uniquement les contacts avec un e-mail.

Requête

curl 'https://app.sendapp.ai/api/contacts?page=1&per_page=50&search=mario' \
  -H 'X-API-Key: YOUR_API_KEY'

<?php
$ch = curl_init('https://app.sendapp.ai/api/contacts?page=1&per_page=50&search=mario');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY'],
]);
echo curl_exec($ch);
curl_close($ch);

const params = new URLSearchParams({ page: 1, per_page: 50, search: 'mario' });
const res = await fetch('https://app.sendapp.ai/api/contacts?' + params, {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
console.log(await res.json());

Réponse (200 OK)

{
  "status": "success",
  "pagination": {
    "total": 128,
    "per_page": 50,
    "current_page": 1,
    "last_page": 3
  },
  "contacts": [
    {
      "id": 4021,
      "name": "Mario Rossi",
      "phone": "391234567890",
      "email": "mario.rossi@example.com",
      "tags": [
        "vip",
        "newsletter"
      ],
      "metadata": {
        "import_source": "csv"
      },
      "created_at": "2026-07-13 10:00:00",
      "updated_at": "2026-07-13 10:00:00"
    }
  ]
}

Erreur

{
  "status": "error",
  "message": "Invalid API key."
}