> ## 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 a campaign's lead imports > Returns the campaign's 20 latest lead imports, newest first, with their progress and what was added or skipped. ## OpenAPI ```json { "openapi": "3.2.0", "info": { "title": "Bavlio API", "version": "1.0.0" }, "paths": { "/campaigns/{id}/imports": { "get": { "tags": [ "Lead imports" ], "operationId": "leadImports.listLeadImports", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "string", "description": "Campaign id." }, "required": true } ], "security": [ { "bearer": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "imports": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Import id." }, "file_name": { "type": "string", "description": "The name the import was started with." }, "status": { "type": "string", "enum": [ "running", "done", "failed" ], "description": "running while rows are left, then done, or failed with the reason in failure." }, "rows": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "description": "Rows in the file.", "allOf": [ { "minimum": 0 } ] }, "processed": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "description": "Rows read so far.", "allOf": [ { "minimum": 0 } ] }, "added": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "description": "Leads added to the campaign.", "allOf": [ { "minimum": 0 } ] }, "credits": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "description": "Credits charged for the added leads.", "allOf": [ { "minimum": 0 } ] }, "skipped": { "type": "object", "properties": { "no_name": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "allOf": [ { "minimum": 0 } ] }, "no_email": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "allOf": [ { "minimum": 0 } ] }, "no_linkedin": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "allOf": [ { "minimum": 0 } ] }, "missing_details": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "allOf": [ { "minimum": 0 } ] }, "opted_out": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "allOf": [ { "minimum": 0 } ] }, "already_added": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "allOf": [ { "minimum": 0 } ] }, "no_credits": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "allOf": [ { "minimum": 0 } ] } }, "required": [ "no_name", "no_email", "no_linkedin", "missing_details", "opted_out", "already_added", "no_credits" ], "additionalProperties": false, "description": "Rows left out, counted by reason." }, "failure": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Why the import stopped; null unless it failed." }, "started_at": { "type": "string", "description": "When the import started (ISO 8601)." }, "finished_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "When it finished (ISO 8601); null while it runs." } }, "required": [ "id", "file_name", "status", "rows", "processed", "added", "credits", "skipped", "failure", "started_at", "finished_at" ], "additionalProperties": false }, "description": "Newest first." } }, "required": [ "imports" ], "additionalProperties": false } } } }, "400": { "description": "RequestInvalidBody", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestInvalidBodyEncoded" } } } }, "401": { "description": "AuthMissing | AuthInvalid", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/AuthMissingEncoded" }, { "$ref": "#/components/schemas/AuthInvalidEncoded" } ] } } } }, "404": { "description": "WorkspaceNotFound | CampaignNotFound", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/WorkspaceNotFoundEncoded" }, { "$ref": "#/components/schemas/CampaignNotFoundEncoded" } ] } } } } }, "description": "Returns the campaign's 20 latest lead imports, newest first, with their progress and what was added or skipped.", "summary": "List a campaign's lead imports" } } }, "components": { "schemas": { "AuthInvalidEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "AuthInvalid" ] }, "statusCode": { "type": "number", "enum": [ 401 ] }, "code": { "type": "string", "enum": [ "auth_invalid" ] }, "message": { "type": "string", "enum": [ "Bearer credential rejected" ] } }, "required": [ "_tag", "statusCode", "code", "message" ], "additionalProperties": false }, "AuthMissingEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "AuthMissing" ] }, "statusCode": { "type": "number", "enum": [ 401 ] }, "code": { "type": "string", "enum": [ "auth_missing" ] }, "message": { "type": "string", "enum": [ "Bearer credential required" ] } }, "required": [ "_tag", "statusCode", "code", "message" ], "additionalProperties": false }, "RequestInvalidBodyEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "RequestInvalidBody" ] }, "statusCode": { "type": "number", "enum": [ 400 ] }, "code": { "type": "string", "enum": [ "invalid_body" ] }, "message": { "type": "string" } }, "required": [ "_tag", "statusCode", "code", "message" ], "additionalProperties": false }, "WorkspaceNotFoundEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "WorkspaceNotFound" ] }, "statusCode": { "type": "number", "enum": [ 404 ] }, "code": { "type": "string", "enum": [ "workspace_not_found" ] }, "message": { "type": "string", "enum": [ "No such workspace for this account: save a company profile or pick a workspace you belong to" ] } }, "required": [ "_tag", "statusCode", "code", "message" ], "additionalProperties": false }, "CampaignNotFoundEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "CampaignNotFound" ] }, "statusCode": { "type": "number", "enum": [ 404 ] }, "code": { "type": "string", "enum": [ "campaign_not_found" ] }, "message": { "type": "string", "enum": [ "No campaign with this id belongs to the workspace" ] } }, "required": [ "_tag", "statusCode", "code", "message" ], "additionalProperties": false } }, "securitySchemes": { "bearer": { "description": "Send `Authorization: Bearer `. The token is an API key, which starts with `bav_` and comes from creating an API key or starting a registration, or the access token of a Bavlio sign-in.", "type": "http", "scheme": "Bearer" } } }, "security": [], "tags": [ { "name": "Registration", "description": "Open a Bavlio account without signing in. Starting a registration returns an API key for a new ephemeral account, which becomes permanent once its email address is verified." }, { "name": "Authentication", "description": "Identify the calling account, finish a registration and manage the account's API keys." }, { "name": "Account", "description": "The account behind your sign-in, and deleting it." }, { "name": "Workspaces", "description": "A workspace holds the company profile, outreach schedule, team, campaigns and billing Bavlio works with. Calls that act in a workspace use the one whose id is in the bavlio-workspace header, or the account's default workspace when the header is absent." }, { "name": "Teams", "description": "Manage who belongs to a workspace: its members, their roles and the invitations to join it. Each workspace's plan sets how many team seats it has." }, { "name": "Campaigns", "description": "A campaign finds leads that match an ideal customer profile (ICP) and buying signals, and reaches out to them through its sequence of LinkedIn and email steps." }, { "name": "Lead imports", "description": "Bring your own leads: preview a CSV, confirm which column holds what, then import it into a campaign, where the leads go through the same sequence as the ones Bavlio finds." }, { "name": "Sequences", "description": "A campaign's sequence is the steps Bavlio runs for each lead: profile visits, likes, invites, LinkedIn messages, emails, waits and conditions. Every message and email waits in the review queue for approval before it is sent." }, { "name": "Inbox", "description": "Conversations with the people your campaigns reached and, for accounts that opt in, your other LinkedIn and email conversations: read them, reply to them and follow changes live." }, { "name": "Reviews", "description": "Messages and emails go to a lead only after someone approves them. The review queue holds the replies Bavlio drafted for people who answered and the messages and emails it drafted for campaign sequences." }, { "name": "Billing", "description": "The plans on offer and the workspace's subscription and usage. Plan changes, cancellation and the billing portal need the workspace owner or an admin." }, { "name": "LinkedIn", "description": "Connect the LinkedIn accounts your campaigns send from, confirm their sign-ins, choose the country LinkedIn sees them from, and disconnect them." }, { "name": "Meetings", "description": "Meetings booked through the workspace's calendar tool (Google Calendar, Calendly or Cal.com), and the calendar connection that imports them." }, { "name": "Email", "description": "Connect a Bavimail account, add sending domains and tracking domains, and create the inboxes campaigns send email from." } ], "servers": [ { "url": "https://api.bavlio.com" } ] } ```