---
title: "Prospects, newest first, cursor-paged"
method: GET
path: "/prospects"
tags: ["Prospects"]
---

# Prospects, newest first, cursor-paged

`GET /prospects`

## Request

- Base URL: `https://mcp.senders.ai/api/v1`
- URL: `https://mcp.senders.ai/api/v1/prospects`
- Auth: HTTP bearer

Scope: prospects:read

## Query parameters

- `limit` integer
- `cursor` string
- `order` 'desc' | 'asc'
- `campaign_id` integer
- `status` 'pending' | 'contacted' | 'replied' | 'bounced' | 'unsubscribed' | 'dnc' | 'held' | 'meeting_booked'
- `lead_status` 'interested' | 'meeting_booked' | 'not_interested' | 'out_of_office' | 'wrong_person' | 'closed'
- `since` string
- `replied_since` string

## Response `200`

OK

- object
  - `data` Prospect[], required
    - `id` integer, required
    - `campaign_id` integer, nullable
    - `email` string, email, nullable, required
    - `name` string, nullable
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `title` string, nullable
    - `organization` string, nullable
    - `linkedin_url` string, nullable
    - `timezone` string, nullable
    - `status` 'pending' | 'contacted' | 'replied' | 'bounced' | 'unsubscribed' | 'dnc' | 'held' | 'meeting_booked', required
    - `lead_status` 'interested' | 'meeting_booked' | 'not_interested' | 'out_of_office' | 'wrong_person' | 'closed' | 'null', nullable
    - `reply_sentiment` 'positive' | 'negative' | 'neutral' | 'auto_reply' | 'null', nullable
    - `last_contacted_at` string, date-time, nullable: ISO 8601, UTC
    - `replied_at` string, date-time, nullable: ISO 8601, UTC
    - `created_at` string, date-time, nullable: ISO 8601, UTC
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid parameter (bad_request)
- `401`: Missing, wrong or revoked token (unauthorized)
- `403`: Missing scope (forbidden), paused account (account_inactive) or plan without the API (feature_not_enabled)
- `429`: Rate limited (rate_limited, daily_limit). Wait Retry-After seconds.

---

[API](https://skmtc.dev/senders/apis/senders-rest-api.md) · [All operations](https://skmtc.dev/senders/apis/senders-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/senders/apis/senders-rest-api/revisions/3cd9960bc0af?raw)