GET /public/v1/warmlist/{workspaceId}/prospects/{prospectId}

Get a single warmlist prospect with their full engagement history.

GET /public/v1/warmlist/{workspaceId}/prospects/{prospectId}

API key in header x-api-key

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

{
  "statusCode": 1,
  "status": true,
  "message": "example",
  "data": {
    "prospect": {
      "id": "id_01JXY9AZK4KV",
      "first_name": "example",
      "last_name": "example",
      "headline": "example",
      "location": "example",
      "profile_picture": "example",
      "linkedin_url": "https://example.com/linkedin",
      "linkedin_public_id": "linkedin_public_01JXY9AZK4KV",
      "connection_degree": "example",
      "icp_fit": "example",
      "icp_fit_justification": "example",
      "created_at": "2026-01-01T12:00:00Z",
      "engagements": [
        {
          "created_at": "2026-01-01T12:00:00Z",
          "engagement_type": "example",
          "monitored_profile_id": "monitored_profile_01JXY9AZK4KV",
          "post_id": "post_01JXY9AZK4KV",
          "post_text": "example",
          "post_date": "2026-01-01T12:00:00Z",
          "post_engagement_type": "example"
        }
      ]
    }
  }
}

Default Response

Path parameters

· 2

prospectId string required

workspaceId string required

Query parameters

· 1

ownerId string

Admin/Owner only: view a specific workspace member's prospect by their user ID

Path parameters

Query parameters

Responses