PlusVibe.ai
  1. Lead
PlusVibe.ai
  • PlusVibe.ai API Documentation
  • Workspace
    • Get workspaces
      GET
    • Add a new workspace
      POST
  • Campaign
    • Create a new campaign
      POST
    • Create a new subsequence
      POST
    • List campaigns (deprecated)
      GET
    • List all campaigns
      GET
    • Get campaign name
      GET
    • Get campaign status
      GET
    • Get campaign email accounts
      GET
    • Get campaign emails
      GET
    • Set campaign name
      POST
    • Set campaign Schedules
      POST
    • Activate campaign
      POST
    • Pause campaign
      POST
    • Update Campaign
      PATCH
  • Lead
    • Add leads to a campaign
      POST
    • Add leads to a subsequence campaign
      POST
    • Get or search for lead
      GET
    • Delete leads from a campaign
      POST
    • Lead Variable/Label Update or Add
      POST
    • Fetch workspace leads
      GET
    • Update the status of a lead
      POST
  • Email Account
    • List all email accounts in the workspace
      GET
    • Get email account status
      GET
    • Check account vitals
      POST
    • Enable Email account warmup
      POST
    • Pause Email account warmup
      POST
    • Delete Email account
      POST
    • Get Warmup Stats (Individual Account)
      GET
    • Get Warmup Stats (Workspace-Level)
      GET
    • Bulk Add SMTP Accounts
      POST
  • Analytics
    • Get campaign summary
    • Get campaign count (deprecated)
    • Get campaign stats
    • Get all campaigns statistics
  • Unibox
    • Get emails
    • Get count of unread emails
    • Reply to an email
    • Forward an existing email
    • Mark email read
  • Blocklist
    • Get entries in the blocklist
    • Adds entries to the blocklist
    • Delete entries in the blocklist
  • Webhook
    • PlusVibe Webhook Overview
    • Sample Payload - FIRST_EMAIL_REPLIES, ALL_EMAIL_REPLIES, ALL_POSITIVE_REPLIES
    • Sample Payload - LEAD_MARKED_AS_INTERESTED
    • Sample Payload - EMAIL_SENT
    • Sample Payload - BOUNCED_EMAIL
    • Add a new webhook
    • List webhooks
    • Delete webhook(s)
  • Tag
    • List Tags
  • For Email Infra Provider Partner
    • List workspaces
    • Initiate Google OAuth login flow
    • Initiate Microsoft OAuth login flow
    • Bulk Add SMTP Accounts (via Username and Password)
  1. Lead

Fetch workspace leads

GET
https://api.plusvibe.ai/api/v1/lead/workspace-leads
Retrieve a list of leads based on specified filters like status, campaign, and more.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.plusvibe.ai/api/v1/lead/workspace-leads?workspace_id&campaign_id&status&label&email&first_name&last_name&page&limit&sort&direction' \
--header 'x-api-key;'
Response Response Example
{
    "_id": "66eee7889475e631ac0d156c",
    "organization_id": "65099a0dd96fae8ab61130bf",
    "campaign_id": "66eee42f9475e631ac0d1568",
    "workspace_id": "65099a0dd96fae8ab61130c0",
    "is_completed": 1,
    "current_step": 1,
    "email_account_id": "string",
    "created_at": "2024-09-14T06:29:55.185Z",
    "modified_at": "2024-09-14T06:29:55.185Z",
    "status": "SKIPPED",
    "label": "string",
    "email_acc_name": "string",
    "camp_name": "Campaign Name Example",
    "sent_step": 0,
    "replied_count": 0,
    "opened_count": 0,
    "last_sent_at": "2019-08-24T14:15:22Z",
    "is_mx": -1,
    "mx": "string",
    "email": "lead@abc.com",
    "first_name": "string",
    "last_name": "string",
    "address_line": "200 Park Ave",
    "city": "New York",
    "state": "string",
    "country": "string",
    "country_code": "string",
    "phone_number": "(021) 765-3710",
    "job_title": "string",
    "department": "string",
    "company_name": "ACME Company",
    "company_website": "https://company.com",
    "industry": "string",
    "linkedin_person_url": "string",
    "linkedin_company_url": "string",
    "total_steps": 4,
    "bounce_msg": "string"
}

Request

Query Params

Header Params

Responses

🟢200OK
application/json
A list of leads matching the filters.
Body

Modified at 2025-08-07 11:24:38
Previous
Lead Variable/Label Update or Add
Next
Update the status of a lead
Built with