> ## Documentation Index > Fetch the complete documentation index at: https://docs.fuseai.com/llms.txt > Use this file to discover all available pages before exploring further. # List the token owner's campaigns with headline analytics > Lists the campaigns you own with their headline analytics, newest first. Campaigns delegated to you, and campaigns your team's visibility settings share with you, are NOT listed: every other endpoint in this family resolves the token owner's own campaigns only, so listing them would hand back ids that answer 404 everywhere else. `createdBy` is the campaign's owner and is therefore always the token owner. Deleted campaigns are never returned. Engagement rates are percentages of messages sent. Rate limit: 30 requests/minute and 1,000/day per token owner, shared by every campaign, scheduled-send, campaign-template and knowledge-hub endpoint. Errors: - `422` `VALIDATION_FAILED` — A query parameter is out of range or not one of the accepted values; `param` names it. - `429` `RATE_LIMITED` — More than 30 campaign requests in a minute, or 1,000 in a day, for this token owner (the bucket is shared by every /business/campaigns, /business/scheduled-sends, /business/campaign-templates and /business/knowledge-hubs call). - `500` `UNEXPECTED_ERROR` — An unhandled failure; the detail stays in our logs and is never returned. Requires one of the following token scopes: campaigns. ## OpenAPI ````yaml /openapi.json get /business/campaigns openapi: 3.1.0 info: title: Fuse Business API version: 1.0.0 description: >- External API for lists, campaigns, prospect search and contacts. Authenticate with your API token as HTTP Basic. All paths are under /api/v1. servers: - url: https://api.tryfuse.ai/api/v1 description: Production security: - basicAuth: [] tags: - name: Lists - name: Custom columns - name: Smart columns - name: Exports - name: Campaigns - name: Knowledge hubs - name: Analytics - name: Website intent - name: Account - name: Prospect search - name: Campaign steps - name: Scheduled sends - name: Campaign templates - name: Agents - name: Research - name: Company search - name: Saved searches - name: Folders - name: Contacts paths: /business/campaigns: get: tags: - Campaigns summary: List the token owner's campaigns with headline analytics description: >- Lists the campaigns you own with their headline analytics, newest first. Campaigns delegated to you, and campaigns your team's visibility settings share with you, are NOT listed: every other endpoint in this family resolves the token owner's own campaigns only, so listing them would hand back ids that answer 404 everywhere else. `createdBy` is the campaign's owner and is therefore always the token owner. Deleted campaigns are never returned. Engagement rates are percentages of messages sent. Rate limit: 30 requests/minute and 1,000/day per token owner, shared by every campaign, scheduled-send, campaign-template and knowledge-hub endpoint. Errors: - `422` `VALIDATION_FAILED` — A query parameter is out of range or not one of the accepted values; `param` names it. - `429` `RATE_LIMITED` — More than 30 campaign requests in a minute, or 1,000 in a day, for this token owner (the bucket is shared by every /business/campaigns, /business/scheduled-sends, /business/campaign-templates and /business/knowledge-hubs call). - `500` `UNEXPECTED_ERROR` — An unhandled failure; the detail stays in our logs and is never returned. Requires one of the following token scopes: campaigns. operationId: listCampaigns parameters: - name: limit in: query required: false description: Page size, 1-100 (default 25). schema: type: integer minimum: 1 maximum: 100 default: 25 description: Page size, 1-100 (default 25). - name: pageNum in: query required: false description: 1-based page number (default 1). schema: type: integer minimum: 1 default: 1 description: 1-based page number (default 1). - name: search in: query required: false description: >- Free text matched case-insensitively against the campaign name only (1-200 characters); any string is accepted. The value reaches the store as a regular expression rather than a literal, so metacharacters such as ( ) [ ] + * ? | are interpreted — send plain words, or escape them. A term that matches no campaign returns an empty page, not an error. schema: type: string minLength: 1 maxLength: 200 description: >- Free text matched case-insensitively against the campaign name only (1-200 characters); any string is accepted. The value reaches the store as a regular expression rather than a literal, so metacharacters such as ( ) [ ] + * ? | are interpreted — send plain words, or escape them. A term that matches no campaign returns an empty page, not an error. - name: type in: query required: false description: >- Restrict to ai-generated or manual campaigns — the same values a campaign's `type` reports. schema: type: string enum: - ai-generated - manual description: >- Restrict to ai-generated or manual campaigns — the same values a campaign's `type` reports. - name: status in: query required: false description: >- Restrict to one status: initializing (draft, not yet approved), active (approved and sending), stopped (stopped via /stop or deleted), paused_manual (paused by the app), initialization_failed (AI initialization failed; see initializationError). schema: type: string enum: - active - initializing - initialization_failed - stopped - paused_manual description: >- Restrict to one status: initializing (draft, not yet approved), active (approved and sending), stopped (stopped via /stop or deleted), paused_manual (paused by the app), initialization_failed (AI initialization failed; see initializationError). - name: folderId in: query required: false description: >- Return only campaigns filed in this sequences folder (see GET /business/folders). schema: type: string description: >- Return only campaigns filed in this sequences folder (see GET /business/folders). responses: '200': description: Success headers: RateLimit-Limit: schema: type: integer description: Requests permitted in the current window. RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. RateLimit-Reset: schema: type: integer description: Seconds until the current window resets. content: application/json: schema: type: object properties: campaigns: type: array items: type: object properties: id: type: - string - 'null' name: type: - string - 'null' status: type: - string - 'null' enum: - initializing - active - stopped - paused_manual - initialization_failed - null type: type: - string - 'null' enum: - manual - ai-generated - null createdAt: type: - string - 'null' format: date-time startDate: type: - string - 'null' format: date-time description: >- When sending may start; null until the campaign has a start date. folderId: type: - string - 'null' description: >- Sequences folder the campaign is filed in, or null for the root. createdBy: type: - string - 'null' description: Display name of the campaign's owner. leadsStatus: type: - string - 'null' description: >- Enrollment progress of the source lists (for example not_started, in_progress, completed). initializationError: type: - string - 'null' description: Our own status text when AI initialization failed. autoReply: type: boolean isDynamic: type: boolean channels: type: array items: type: string lists: type: array items: type: object properties: id: type: - string - 'null' name: type: - string - 'null' required: - id - name recipients: type: integer description: Contacts enrolled in the campaign. messagesSent: type: integer completedActions: type: object properties: emails: type: integer linkedinMessages: type: integer linkedinInvites: type: integer inmails: type: integer profileVisits: type: integer postsLiked: type: integer callsMade: type: integer required: - emails - linkedinMessages - linkedinInvites - inmails - profileVisits - postsLiked - callsMade opened: type: object properties: count: type: integer rate: type: number description: Percentage of messages sent, 0-100. required: - count - rate clicked: type: object properties: count: type: integer rate: type: number description: Percentage of messages sent, 0-100. required: - count - rate replied: type: object properties: count: type: integer rate: type: number description: Percentage of messages sent, 0-100. required: - count - rate positiveReplied: type: object properties: count: type: integer rate: type: number description: Percentage of messages sent, 0-100. required: - count - rate required: - id - name - status - type - createdAt - startDate - folderId - createdBy - leadsStatus - initializationError - autoReply - isDynamic - channels - lists - recipients - messagesSent - completedActions - opened - clicked - replied - positiveReplied pagination: type: object properties: page: type: integer description: 1-based page number this response covers. pageSize: type: integer description: Rows requested per page. total: type: integer description: Total rows matching the query. totalPages: type: integer description: Total pages at this page size. required: - page - pageSize - total - totalPages required: - campaigns - pagination example: campaigns: - id: 6a8da7718707dbcfb4448b96 name: Q3 fintech outreach status: active type: manual createdAt: '2026-08-25T14:32:17.586Z' startDate: '2026-08-26T00:00:00.000Z' folderId: null createdBy: Sofiia Hryshyna leadsStatus: completed initializationError: null autoReply: false isDynamic: false channels: - email lists: - id: 6a1edba88936e0fe1b20287c name: Fintech CFOs - US recipients: 9 messagesSent: 4 completedActions: emails: 4 linkedinMessages: 0 linkedinInvites: 0 inmails: 0 profileVisits: 0 postsLiked: 0 callsMade: 0 opened: count: 3 rate: 75 clicked: count: 1 rate: 25 replied: count: 1 rate: 25 positiveReplied: count: 0 rate: 0 pagination: page: 1 pageSize: 25 total: 210 totalPages: 9 '400': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' security: - basicAuth: [] components: schemas: Error: type: object properties: error: type: object properties: code: type: string message: type: string param: type: - string - 'null' doc_url: type: - string - 'null' request_id: type: - string - 'null' required: - code - message required: - error securitySchemes: basicAuth: type: http scheme: basic description: >- Your API token (`af_…`) as the Basic-auth username, with an empty password. ````