Skip to main content
GET
/
v1
/
leads
Lister les prospects
curl --request GET \
  --url https://api.setteo.io/v1/leads \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "ext_id": "crm_123",
      "first_name": "Jean",
      "last_name": "Dupont",
      "username": "jdupont",
      "image": "https://example.com/avatar.jpg",
      "email": "jean.dupont@example.com",
      "phone": "+33612345678",
      "source": "api",
      "warmth": "warm",
      "pipeline_stage": "qualified",
      "variables": {
        "plan": "pro"
      },
      "whatsapp_phone_number_id": 12,
      "created_at": "2026-07-08T12:00:00Z",
      "updated_at": "2026-07-08T12:00:00Z",
      "tags": [
        {
          "id": 1,
          "label": "Prospect chaud",
          "description": "Prospect prêt à réserver un appel.",
          "pipeline_stage": "qualified",
          "created_at": "2026-07-08T12:00:00Z",
          "updated_at": "2026-07-08T12:00:00Z"
        }
      ]
    }
  ],
  "links": {
    "first": "<string>",
    "last": "<string>",
    "prev": "<string>",
    "next": "<string>"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 4,
    "path": "https://api.setteo.io/v1/leads",
    "per_page": 25,
    "to": 25,
    "total": 83
  }
}

Authorizations

Authorization
string
header
required

Token API généré depuis votre espace de travail Setteo.

Query Parameters

page
integer
default:1

Numéro de page.

Required range: x >= 1
per_page
integer
default:25

Nombre de résultats par page.

Required range: 10 <= x <= 100

Response

Liste paginée de prospects.

data
object[]
required
meta
object
required