GET /public/v1/campaigns/{campaignId}/prospects

List prospects in a campaign with filtering and pagination. Workspace admins and owners can access campaigns created on behalf of other workspace members.

GET /public/v1/campaigns/{campaignId}/prospects

API key in header x-api-key

curl --request GET \
  --url 'https://api.joinvalley.co/public/v1/campaigns/{CAMPAIGNID}/prospects' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "statusCode": 1,
  "status": true,
  "message": "example",
  "data": {
    "prospects": [
      {
        "campaign_id": "campaign_01JXY9AZK4KV",
        "campaign_name": "example",
        "id": "id_01JXY9AZK4KV",
        "first_name": "example",
        "last_name": "example",
        "linkedin_public_id": "linkedin_public_01JXY9AZK4KV",
        "profile_picture": "example",
        "sub_title": "example",
        "company_name": "example",
        "company_website": "example",
        "company_logo": "example",
        "current_position_title": "example",
        "email": "[email protected]",
        "phone_number": "example",
        "city": "example",
        "state": "example",
        "country": "example",
        "industry": "example",
        "status": "example",
        "interest_level": "example",
        "icp_fit": "example",
        "icp_fit_justification": "example",
        "accepted_connection_request": true,
        "responded": true,
        "created_at": "2026-01-01T12:00:00Z"
      }
    ],
    "pagination": {
      "limit": 1,
      "offset": 1,
      "total": 1,
      "hasMore": true
    }
  }
}

Default Response

Path parameters

· 1

campaignId string required

Query parameters

· 5

limit number · min: 1· max: 100· default: 20

offset number · min: 0· default: 0

search string · max length: 200

sort string

status string

Path parameters

Query parameters

Responses