> ## Documentation Index > Fetch the complete documentation index at: https://bavlio.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Campaign Leads > List leads for a campaign with their current status. Includes lead data from the dataset for display purposes. Args: campaign_id: Campaign ID current_user: Authenticated user information service: Campaign service instance status_filter: Optional status filter page: Page number (1-indexed) page_size: Items per page (max 200) Returns: Paginated list of campaign leads with lead data ## OpenAPI ````yaml https://api.bavlio.com/openapi.json get /api/v1/campaigns/{campaign_id}/leads openapi: 3.1.0 info: title: Bavlio API description: >- Outreach automation API — lead enrichment, email campaigns, LinkedIn automation, and AI agent. Full docs at https://docs.bavlio.com. version: 1.0.0 servers: [] security: [] tags: - name: API Keys description: >- Create, list, and revoke API keys for programmatic access. JWT authentication required. - name: credits description: Credit balance, cost estimates, and transaction history. - name: campaigns description: Create, manage, launch, and monitor email campaigns. - name: campaign-personalization description: AI-powered email subject and body personalization for campaigns. - name: email-finder description: Find and verify email addresses for prospects. - name: email-verification description: Validate email addresses and prune invalid entries from datasets. - name: sender-profiles description: Manage sender identity profiles for outreach. - name: sender-profile-chat description: Interactive chat for building sender profiles. - name: templates description: Email template CRUD. - name: suppression description: Do-not-contact suppression list management. - name: datasets description: Lead dataset listing, download, and updates. - name: user-extractions description: Uploaded lead file management and processing. - name: enrichment-chat description: Interactive chat for data enrichment sessions. - name: enrichment-processing description: Batch lead enrichment processing. - name: File Upload (CSV/Excel) description: Upload and preview CSV/Excel lead files. - name: connected-accounts description: LinkedIn account connections via Unipile. - name: linkedin-content description: LinkedIn post creation, scheduling, and management. - name: linkedin-playground description: Direct LinkedIn actions (profile lookup, messaging, engagement). - name: bavimail-proxy description: BaviMail domain, alias, and email management. - name: agent description: Bavi AI agent chat with SSE streaming. - name: notifications description: Notification preferences and delivery. - name: referral description: Referral code management and stats. - name: feedback description: User feedback submission. - name: authentication description: JWT token verification and user info. - name: Google OAuth description: Google OAuth login flow and access tokens. - name: Google Sheets OAuth description: Google Sheets import and access management. - name: stripe description: Stripe checkout, billing portal, and subscription status. JWT only. - name: users description: User quota and usage information. - name: Health description: Health checks and system status. - name: Personalization description: Core lead personalization engine. - name: Session Management description: Enrichment session lifecycle. - name: Session Processing description: Session data processing. - name: webhooks description: Inbound webhook handlers (Stripe, BaviMail, Unipile). paths: /api/v1/campaigns/{campaign_id}/leads: get: tags: - campaigns summary: List Campaign Leads description: |- List leads for a campaign with their current status. Includes lead data from the dataset for display purposes. Args: campaign_id: Campaign ID current_user: Authenticated user information service: Campaign service instance status_filter: Optional status filter page: Page number (1-indexed) page_size: Items per page (max 200) Returns: Paginated list of campaign leads with lead data operationId: list_campaign_leads_api_v1_campaigns__campaign_id__leads_get parameters: - name: campaign_id in: path required: true schema: type: string format: uuid title: Campaign Id - name: status in: query required: false schema: anyOf: - $ref: '#/components/schemas/CampaignLeadStatus' - type: 'null' title: Status - name: page in: query required: false schema: type: integer minimum: 1 description: Page number default: 1 title: Page description: Page number - name: page_size in: query required: false schema: type: integer maximum: 200 minimum: 1 description: Items per page default: 50 title: Page Size description: Items per page responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CampaignLeadListResponse' '401': description: Unauthorized - Invalid or missing JWT token '403': description: Forbidden - Insufficient permissions '404': description: Campaign not found '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: CampaignLeadStatus: type: string enum: - pending - active - processing - completed - replied - bounced - unsubscribed - failed - paused - invalid - waiting_acceptance - connected - connection_ignored - rate_limited title: CampaignLeadStatus description: Campaign lead status values. CampaignLeadListResponse: properties: leads: items: $ref: '#/components/schemas/CampaignLeadResponse' type: array title: Leads description: List of leads total: type: integer title: Total description: Total number of leads page: type: integer title: Page description: Current page number page_size: type: integer title: Page Size description: Items per page type: object required: - leads - total - page - page_size title: CampaignLeadListResponse description: Response model for campaign lead list. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError CampaignLeadResponse: properties: campaign_lead_id: type: string format: uuid title: Campaign Lead Id description: Unique lead identifier campaign_id: type: string format: uuid title: Campaign Id description: Associated campaign ID dataset_id: type: string format: uuid title: Dataset Id description: Source dataset ID row_index: type: integer title: Row Index description: Row index in dataset status: $ref: '#/components/schemas/CampaignLeadStatus' description: Current lead status current_step: type: integer title: Current Step description: Current step number next_action_at: anyOf: - type: string format: date-time - type: 'null' title: Next Action At description: Next scheduled action assigned_alias_id: anyOf: - type: string - type: 'null' title: Assigned Alias Id description: Assigned sending alias variant_map: additionalProperties: type: string type: object title: Variant Map description: Step to variant mapping lead_data: additionalProperties: true type: object title: Lead Data description: Lead data from dataset created_at: type: string format: date-time title: Created At description: Creation timestamp updated_at: type: string format: date-time title: Updated At description: Last update timestamp type: object required: - campaign_lead_id - campaign_id - dataset_id - row_index - status - current_step - variant_map - lead_data - created_at - updated_at title: CampaignLeadResponse description: Response model for campaign lead with associated lead data. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: HTTPBearer: type: http scheme: bearer ````