Retrieves a list of campaigns associated with a specified organisation. This includes campaigns’ names, subjects, statuses, creation dates, and email tracking settings.
Path Parameters
organisation_id (int): The ID of the organisation for which campaigns are being fetched.
Headers
X-API-Key: API key for user authentication. Ensures that the request is made by an authorised user.
Response
Returns a list of Campaign objects, each encapsulating details about a specific email campaign, including its ID, name, subject, creation date, status (e.g., pending, active, completed), and whether email tracking is enabled.
Errors
403 Forbidden: If the authenticated user is not a member of the specified organisation.
404 Not Found: The campaign does not belong to the specified organisation.
GET
/
api
/
v1
/
campaigns
Fetch Campaigns Api
curl --request GET \ --url https://services.meetchase.ai/api/v1/campaigns \ --header 'X-API-Key: <api-key>'
Manages the automation settings for a campaign's AI assistant.
Each setting determines whether the AI should handle a specific event
automatically (True) or flag it for manual human review (False). Think of
these as permissions for the AI to act on its own.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"ChaseLabs Docs","colors":{"primary":"#FF5D5D","light":"#FF5D5D","dark":"#FF5D5D"},"favicon":"/Favicon.png","logo":{"light":"https://mintcdn.com/chaselabs/q2b5RS8qgCT-5kp8/logo/light.svg?fit=max\u0026auto=format\u0026n=q2b5RS8qgCT-5kp8\u0026q=85\u0026s=7c28bbef56089dc7d49192a80c099af8","dark":"https://mintcdn.com/chaselabs/q2b5RS8qgCT-5kp8/logo/dark.svg?fit=max\u0026auto=format\u0026n=q2b5RS8qgCT-5kp8\u0026q=85\u0026s=7be9d1ecc8ff148648b82f6d499e3473"},"navbar":{"links":[{"label":"Support","href":"mailto:team@meetchase.ai"}],"primary":{"type":"button","label":"Dashboard","href":"https://go.meetchase.ai"}},"footer":{"socials":{"x":"https://x.com/meetchaselabs","github":"https://github.com/Chase-Labs","linkedin":"https://linkedin.com/company/chaselabs"}},"fonts":{"heading":{"family":"Outfit"},"body":{"family":"Outfit"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Documentation","href":"https://docs.meetchase.ai","icon":"book-open-cover"},{"anchor":"Zapier","href":"https://zapier.com/developer/public-invite/218425/33faeff99870659b59266ebfed7caf43/","icon":"bolt"},{"anchor":"Blog","href":"https://meetchase.ai/blog","icon":"newspaper"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"chaselabs","hasAudioNarration":false,"actualSubdomain":"chaselabs","customDomains":["docs.meetchase.ai"],"gitSource":{"type":"github","owner":"chase-labs","repo":"public-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20c6efca764992bd9d1e2a","collectionId":"a802c4df-b023-4085-ba86-256541d04c41","schemaVersion":"v2"},"entitlements":{},"buildId":"6ae9246423e9642788d63ed1:success","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API Reference","count":14},{"language":"default","tag":"Campaigns","count":6},{"language":"default","tag":"Contacts","count":4},{"language":"default","tag":"Guides","count":4},{"language":"default","tag":"Meetings \u0026 Conversions","count":2},{"language":"default","tag":"API Documentation","count":1},{"language":"default","tag":"AI SDRs","count":1},{"language":"default","tag":"Documentation","count":1},{"language":"default","tag":"Getting Started","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/endpoint/fetchCampaigns","slug":"/api-reference/endpoint/fetchCampaigns","pageMetadata":{"title":"Fetch Campaigns","openapi":"GET /api/v1/campaigns","description":"Retrieves a list of campaigns associated with a specified organisation. This includes campaigns' names, subjects, statuses, creation dates, and email tracking settings.\n\n### Path Parameters\n\n- `organisation_id` (`int`): The ID of the organisation for which campaigns are being fetched.\n\n### Headers\n\n- `X-API-Key`: API key for user authentication. Ensures that the request is made by an authorised user.\n\n### Response\n\n- Returns a list of `Campaign` objects, each encapsulating details about a specific email campaign, including its ID, name, subject, creation date, status (e.g., pending, active, completed), and whether email tracking is enabled.\n\n### Errors\n\n- `403 Forbidden`: If the authenticated user is not a member of the specified organisation.\n- `404 Not Found`: The campaign does not belong to the specified organisation.","href":"/api-reference/endpoint/fetchCampaigns"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n h3: \"h3\",\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Retrieves a list of campaigns associated with a specified organisation. This includes campaigns’ names, subjects, statuses, creation dates, and email tracking settings.\"\n }), \"\\n\", _jsx(_components.h3, {\n children: \"Path Parameters\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"organisation_id\"\n }), \" (\", _jsx(_components.code, {\n children: \"int\"\n }), \"): The ID of the organisation for which campaigns are being fetched.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.h3, {\n children: \"Headers\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"X-API-Key\"\n }), \": API key for user authentication. Ensures that the request is made by an authorised user.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.h3, {\n children: \"Response\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"Returns a list of \", _jsx(_components.code, {\n children: \"Campaign\"\n }), \" objects, each encapsulating details about a specific email campaign, including its ID, name, subject, creation date, status (e.g., pending, active, completed), and whether email tracking is enabled.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.h3, {\n children: \"Errors\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"403 Forbidden\"\n }), \": If the authenticated user is not a member of the specified organisation.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"404 Not Found\"\n }), \": The campaign does not belong to the specified organisation.\"]\n }), \"\\n\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Fetch Campaigns","openapi":"GET /api/v1/campaigns","description":"Retrieves a list of campaigns associated with a specified organisation. This includes campaigns' names, subjects, statuses, creation dates, and email tracking settings.\n\n### Path Parameters\n\n- `organisation_id` (`int`): The ID of the organisation for which campaigns are being fetched.\n\n### Headers\n\n- `X-API-Key`: API key for user authentication. Ensures that the request is made by an authorised user.\n\n### Response\n\n- Returns a list of `Campaign` objects, each encapsulating details about a specific email campaign, including its ID, name, subject, creation date, status (e.g., pending, active, completed), and whether email tracking is enabled.\n\n### Errors\n\n- `403 Forbidden`: If the authenticated user is not a member of the specified organisation.\n- `404 Not Found`: The campaign does not belong to the specified organisation.","href":"/api-reference/endpoint/fetchCampaigns"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Public API Routes","Campaign Routes"],"summary":"Fetch Campaigns Api","description":"Retrieves a list of campaigns associated with a specified organisation. This includes campaigns' names, subjects, statuses, creation dates, and email tracking settings.\n\n### Path Parameters\n\n- `organisation_id` (`int`): The ID of the organisation for which campaigns are being fetched.\n\n### Headers\n\n- `X-API-Key`: API key for user authentication. Ensures that the request is made by an authorised user.\n\n### Response\n\n- Returns a list of `Campaign` objects, each encapsulating details about a specific email campaign, including its ID, name, subject, creation date, status (e.g., pending, active, completed), and whether email tracking is enabled.\n\n### Errors\n\n- `403 Forbidden`: If the authenticated user is not a member of the specified organisation.\n- `404 Not Found`: The campaign does not belong to the specified organisation.","operationId":"fetch_campaigns_api_api_v1_campaigns_get","responses":{"200":"ad5185c7-2836-4fec-81c3-b9d5ef9e196a"},"security":["2fabd621-ebca-492a-b42d-8d9ecf314e91"],"method":"get","type":"path","servers":["1fadd3a3-e71c-47e8-a0a0-bb3283f27699"],"path":"/api/v1/campaigns","baseUrlOptions":["https://services.meetchase.ai"],"title":"Fetch Campaigns Api","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"ad5185c7-2836-4fec-81c3-b9d5ef9e196a":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"properties":{"name":{"type":"string","maxLength":63,"minLength":1,"title":"Name","isRequired":true,"uniqueKey":"items.[INDEX].name","typeLabel":"string"},"meeting_duration":{"type":"integer","exclusiveMaximum":256,"exclusiveMinimum":0,"title":"Meeting Duration","isRequired":true,"uniqueKey":"items.[INDEX].meeting_duration","typeLabel":"integer"},"test_mode":{"type":"boolean","title":"Test Mode","isRequired":true,"uniqueKey":"items.[INDEX].test_mode","typeLabel":"boolean"},"id":{"type":"integer","title":"Id","isRequired":true,"uniqueKey":"items.[INDEX].id","typeLabel":"integer"},"status":{"type":"string","title":"Status","isRequired":true,"uniqueKey":"items.[INDEX].status","typeLabel":"string"},"email_tracking":{"type":"boolean","title":"Email Tracking","isRequired":true,"uniqueKey":"items.[INDEX].email_tracking","typeLabel":"boolean"},"link_tracking":{"type":"boolean","title":"Link Tracking","isRequired":true,"uniqueKey":"items.[INDEX].link_tracking","typeLabel":"boolean"},"include_disclaimer":{"type":"boolean","title":"Include Disclaimer","isRequired":true,"uniqueKey":"items.[INDEX].include_disclaimer","typeLabel":"boolean"},"auto_pilot_settings":{"properties":{"cancel_meeting":{"type":"boolean","title":"Cancel Meeting","description":"If True, the AI automatically handles meeting cancellations. If False, these events are flagged for human review.","default":false,"uniqueKey":"items.[INDEX].auto_pilot_settings.cancel_meeting","typeLabel":"boolean"},"create_meeting":{"type":"boolean","title":"Create Meeting","description":"If True, the AI automatically schedules new meetings. If False, proposed meetings require manual confirmation.","default":false,"uniqueKey":"items.[INDEX].auto_pilot_settings.create_meeting","typeLabel":"boolean"},"do_not_contact":{"type":"boolean","title":"Do Not Contact","description":"If True, the AI automatically processes 'do not contact' or opt-out requests. If False, these critical requests are flagged for a human to process.","default":true,"uniqueKey":"items.[INDEX].auto_pilot_settings.do_not_contact","typeLabel":"boolean"},"do_not_respond":{"type":"boolean","title":"Do Not Respond","description":"If True, the AI automatically archives emails that do not require a response (e.g., 'Thanks!'). If False, a human will review these emails first.","default":false,"uniqueKey":"items.[INDEX].auto_pilot_settings.do_not_respond","typeLabel":"boolean"},"move_meeting":{"type":"boolean","title":"Move Meeting","description":"If True, the AI automatically handles requests to reschedule a meeting. If False, rescheduling requests are flagged for human review.","default":false,"uniqueKey":"items.[INDEX].auto_pilot_settings.move_meeting","typeLabel":"boolean"},"put_on_hold":{"type":"boolean","title":"Put On Hold","description":"If True, the AI automatically schedules a reconnect action after receiving an Out of Office (OOO) reply. If False, OOO replies are flagged for manual review.","default":true,"uniqueKey":"items.[INDEX].auto_pilot_settings.put_on_hold","typeLabel":"boolean"},"send_email":{"type":"boolean","title":"Send Email","description":"If True, the AI is permitted to send standard email replies. If False, all draft replies must be approved by a human first.","default":false,"uniqueKey":"items.[INDEX].auto_pilot_settings.send_email","typeLabel":"boolean"},"send_reconnect_email":{"type":"boolean","title":"Send Reconnect Email","description":"If True, the AI automatically sends follow-up or 'reconnect' emails according to the campaign schedule. If False, reconnect emails are flagged for review.","default":false,"uniqueKey":"items.[INDEX].auto_pilot_settings.send_reconnect_email","typeLabel":"boolean"},"send_referral_email":{"type":"boolean","title":"Send Referral Email","description":"If True, the AI automatically engages with new contacts who have been referred. If False, referral engagements are sent to a human for review.","default":false,"uniqueKey":"items.[INDEX].auto_pilot_settings.send_referral_email","typeLabel":"boolean"},"unsuccessful_delivery":{"type":"boolean","title":"Unsuccessful Delivery","description":"If True, the AI automatically processes bounce-back notifications from unsuccessful deliveries. If False, these notifications are flagged for manual review.","default":true,"uniqueKey":"items.[INDEX].auto_pilot_settings.unsuccessful_delivery","typeLabel":"boolean"}},"type":"object","title":"AutoPilotSettings","description":"Manages the automation settings for a campaign's AI assistant.\n\nEach setting determines whether the AI should handle a specific event\nautomatically (`True`) or flag it for manual human review (`False`). Think of\nthese as permissions for the AI to act on its own.","examples":[{"cancel_meeting":false,"create_meeting":false,"do_not_contact":true,"do_not_respond":false,"move_meeting":false,"put_on_hold":true,"send_email":false,"send_reconnect_email":false,"send_referral_email":false,"unsuccessful_delivery":true}],"isRequired":true,"uniqueKey":"items.[INDEX].auto_pilot_settings","typeLabel":"AutoPilotSettings · object"},"created_at":{"type":"string","format":"date-time","title":"Created At","isRequired":true,"uniqueKey":"items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"unsubscribe_mode":{"type":"string","enum":["off","one-click","text"],"title":"Unsubscribe Mode","default":"one-click","uniqueKey":"items.[INDEX].unsubscribe_mode","typeLabel":"enum\u003cstring>"},"auto_enrich":{"type":"boolean","title":"Auto Enrich","default":false,"uniqueKey":"items.[INDEX].auto_enrich","typeLabel":"boolean"}},"type":"object","required":["name","meeting_duration","test_mode","id","status","email_tracking","link_tracking","include_disclaimer","auto_pilot_settings","created_at"],"title":"CampaignExternal","examples":[{"auto_enrich":false,"auto_pilot_settings":{"cancel_meeting":false,"create_meeting":false,"do_not_contact":true,"do_not_respond":false,"move_meeting":false,"put_on_hold":true,"send_email":false,"send_reconnect_email":false,"send_referral_email":false,"unsuccessful_delivery":true},"created_at":"2023-11-05 17:26:49.244856","email_tracking":false,"id":1,"include_disclaimer":true,"link_tracking":false,"meeting_duration":30,"name":"Lead Generation Campaign","status":"PENDING","test_mode":false,"unsubscribe_mode":"one-click"}],"uniqueKey":"items.[INDEX]","typeLabel":"CampaignExternal · object"},"type":"array","title":"Response Fetch Campaigns Api Api V1 Campaigns Get","uniqueKey":"","typeLabel":"CampaignExternal · object[]"},"examples":{"Example":{"title":"Example","value":[{"auto_enrich":false,"auto_pilot_settings":{"cancel_meeting":false,"create_meeting":false,"do_not_contact":true,"do_not_respond":false,"move_meeting":false,"put_on_hold":true,"send_email":false,"send_reconnect_email":false,"send_referral_email":false,"unsuccessful_delivery":true},"created_at":"2023-11-05 17:26:49.244856","email_tracking":false,"id":1,"include_disclaimer":true,"link_tracking":false,"meeting_duration":30,"name":"Lead Generation Campaign","status":"PENDING","test_mode":false,"unsubscribe_mode":"one-click"}]}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"2fabd621-ebca-492a-b42d-8d9ecf314e91":{"API Key":{"type":"apiKey","description":"Key used to authenticate user API requests.","in":"header","name":"X-API-Key","scopes":[]}}},"servers":{"1fadd3a3-e71c-47e8-a0a0-bb3283f27699":{"url":"https://services.meetchase.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"Key used to authenticate user API requests.","in":"header","name":"X-API-Key","scopes":[]},"schema":{"title":"X-API-Key","type":"string","description":"Key used to authenticate user API requests.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"API Key","name":"X-API-Key"}],"title":"API Key"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"chaselabs","siteName":"ChaseLabs Docs","title":"Fetch Campaigns - ChaseLabs Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T05:52:36.180Z","originalFileLocation":"api-reference/endpoint/fetchCampaigns.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieves a list of campaigns associated with a specified organisation. This includes campaigns\u0026#x27; names, subjects, statuses, creation dates, and email tracking settings. ### Path Parameters - organisation_id (int): The ID of the organisation for which campaigns are being fetched. ### Headers - X-API-Key: API key for user authentication. Ensures that the request is made by an authorised user. ### Response - Returns a list of Campaign objects, each encapsulating details about a specific email campaign, including its ID, name, subject, creation date, status (e.g., pending, active, completed), and whether email tracking is enabled. ### Errors - 403 Forbidden: If the authenticated user is not a member of the specified organisation. - 404 Not Found: The campaign does not belong to the specified organisation.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ChaseLabs Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/chaselabs/jAtBf2JN94wP8Dmz/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/chaselabs/jAtBf2JN94wP8Dmz/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/chaselabs/jAtBf2JN94wP8Dmz/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/chaselabs/jAtBf2JN94wP8Dmz/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/chaselabs/jAtBf2JN94wP8Dmz/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/chaselabs/jAtBf2JN94wP8Dmz/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/chaselabs/jAtBf2JN94wP8Dmz/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/chaselabs/jAtBf2JN94wP8Dmz/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/chaselabs/jAtBf2JN94wP8Dmz/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Fetch Campaigns - ChaseLabs Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves a list of campaigns associated with a specified organisation. This includes campaigns\u0026#x27; names, subjects, statuses, creation dates, and email tracking settings. ### Path Parameters - organisation_id (int): The ID of the organisation for which campaigns are being fetched. ### Headers - X-API-Key: API key for user authentication. Ensures that the request is made by an authorised user. ### Response - Returns a list of Campaign objects, each encapsulating details about a specific email campaign, including its ID, name, subject, creation date, status (e.g., pending, active, completed), and whether email tracking is enabled. ### Errors - 403 Forbidden: If the authenticated user is not a member of the specified organisation. - 404 Not Found: The campaign does not belong to the specified organisation.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ChaseLabs Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.meetchase.ai/api-reference/endpoint/fetchCampaigns\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://chaselabs.mintlify.app/_mintlify/api/og/v2?division=Campaigns\u0026amp;title=Fetch+Campaigns\u0026amp;description=Retrieves+a+list+of+campaigns+associated+with+a+specified+organisation.+This+includes+campaigns%27+names%2C+subjects%2C+statuses%2C+creation+dates%2C+and+email+tracking+s\u0026amp;theme=a49033ef29aa61cd09ed854c\u0026amp;signature=7acabbf427043f246e43ef63dfcc1299bcf5fb7784ba9a5c0683eecefa2ce917\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Fetch Campaigns - ChaseLabs Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves a list of campaigns associated with a specified organisation. This includes campaigns\u0026#x27; names, subjects, statuses, creation dates, and email tracking settings. ### Path Parameters - organisation_id (int): The ID of the organisation for which campaigns are being fetched. ### Headers - X-API-Key: API key for user authentication. Ensures that the request is made by an authorised user. ### Response - Returns a list of Campaign objects, each encapsulating details about a specific email campaign, including its ID, name, subject, creation date, status (e.g., pending, active, completed), and whether email tracking is enabled. ### Errors - 403 Forbidden: If the authenticated user is not a member of the specified organisation. - 404 Not Found: The campaign does not belong to the specified organisation.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://chaselabs.mintlify.app/_mintlify/api/og/v2?division=Campaigns\u0026amp;title=Fetch+Campaigns\u0026amp;description=Retrieves+a+list+of+campaigns+associated+with+a+specified+organisation.+This+includes+campaigns%27+names%2C+subjects%2C+statuses%2C+creation+dates%2C+and+email+tracking+s\u0026amp;theme=a49033ef29aa61cd09ed854c\u0026amp;signature=7acabbf427043f246e43ef63dfcc1299bcf5fb7784ba9a5c0683eecefa2ce917\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/chaselabs/jAtBf2JN94wP8Dmz/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ChaseLabs Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF5D5D\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.meetchase.ai/api-reference/endpoint/fetchCampaigns\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/fetchCampaigns.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.meetchase.ai/#organization\",\"name\":\"ChaseLabs Docs\",\"url\":\"https://docs.meetchase.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/chaselabs/q2b5RS8qgCT-5kp8/logo/light.svg?fit=max\u0026auto=format\u0026n=q2b5RS8qgCT-5kp8\u0026q=85\u0026s=7c28bbef56089dc7d49192a80c099af8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.meetchase.ai#website\",\"name\":\"ChaseLabs Docs\",\"url\":\"https://docs.meetchase.ai\",\"publisher\":{\"@id\":\"https://docs.meetchase.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.meetchase.ai/api-reference/endpoint/fetchCampaigns#webpage\",\"url\":\"https://docs.meetchase.ai/api-reference/endpoint/fetchCampaigns\",\"name\":\"Fetch Campaigns\",\"description\":\"Retrieves a list of campaigns associated with a specified organisation. This includes campaigns' names, subjects, statuses, creation dates, and email tracking settings. ### Path Parameters - organisation_id (int): The ID of the organisation for which campaigns are being fetched. ### Headers - X-API-Key: API key for user authentication. Ensures that the request is made by an authorised user. ### Response - Returns a list of Campaign objects, each encapsulating details about a specific email campaign, including its ID, name, subject, creation date, status (e.g., pending, active, completed), and whether email tracking is enabled. ### Errors - 403 Forbidden: If the authenticated user is not a member of the specified organisation. - 404 Not Found: The campaign does not belong to the specified organisation.\",\"dateModified\":\"2026-01-07T05:52:36.180Z\",\"isPartOf\":{\"@id\":\"https://docs.meetchase.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.meetchase.ai/api-reference/endpoint/fetchCampaigns#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.meetchase.ai/api-reference/endpoint/fetchCampaigns#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Campaigns\",\"item\":\"https://docs.meetchase.ai/api-reference/endpoint/uploadContactToCampaignStart\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Fetch Campaigns\",\"item\":\"https://docs.meetchase.ai/api-reference/endpoint/fetchCampaigns\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.meetchase.ai/api-reference/endpoint/fetchCampaigns#apireference\",\"headline\":\"Fetch Campaigns\",\"name\":\"Fetch Campaigns\",\"description\":\"Retrieves a list of campaigns associated with a specified organisation. This includes campaigns' names, subjects, statuses, creation dates, and email tracking settings. ### Path Parameters - organisation_id (int): The ID of the organisation for which campaigns are being fetched. ### Headers - X-API-Key: API key for user authentication. Ensures that the request is made by an authorised user. ### Response - Returns a list of Campaign objects, each encapsulating details about a specific email campaign, including its ID, name, subject, creation date, status (e.g., pending, active, completed), and whether email tracking is enabled. ### Errors - 403 Forbidden: If the authenticated user is not a member of the specified organisation. - 404 Not Found: The campaign does not belong to the specified organisation.\",\"url\":\"https://docs.meetchase.ai/api-reference/endpoint/fetchCampaigns\",\"mainEntityOfPage\":{\"@id\":\"https://docs.meetchase.ai/api-reference/endpoint/fetchCampaigns#webpage\"},\"dateModified\":\"2026-01-07T05:52:36.180Z\",\"publisher\":{\"@id\":\"https://docs.meetchase.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.meetchase.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ChaseLabs Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"ChaseLabs Docs","nav":{"global":{"anchors":[{"anchor":"Documentation","href":"https://docs.meetchase.ai","icon":"book-open-cover"},{"anchor":"Zapier","href":"https://zapier.com/developer/public-invite/218425/33faeff99870659b59266ebfed7caf43/","icon":"bolt"},{"anchor":"Blog","href":"https://meetchase.ai/blog","icon":"newspaper"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/setup"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"API Keys","href":"/api-reference/api-key"}]},{"group":"Campaigns","pages":[{"title":"Add Contact to Campaign \u0026 Start","openapi":"POST /api/v1/campaigns/{campaign_id}/contacts/upload-and-start","href":"/api-reference/endpoint/uploadContactToCampaignStart"},{"title":"Add Contact to Campaign","openapi":"POST /api/v1/campaigns/{campaign_id}/contacts/upload","description":"This endpoint first uplaods a contact, then adds them to a campaign.\n\n### Path Parameters\n\n- campaign_id (`int`): The ID of the campaign to which the contacts are being added.\n\n### Query Parameters\n\n- bot_id (`int`): (Optional) The ID of the bot responsible for managing the contact's email exchanges within the campaign.\n If not provided, the system will manually assign the contact to a bot.\n- notify (`bool`): A flag the users associated with the campaign should be notified about the new contact. Default is `True`.\n\n### Request Body\n\n- contact (`ContactUpload`): An object containing the contact details to be added to the campaign.\n\n### Headers\n\n`X-API-Key`: The API key for authenticating the request.\n\n### Response\n\n`BaseItem`: The ID of the newly inserted contact.\n\n### Errors\n\n- `400 Bad Request`: If the contact is already associated with the organisation or there are\n no bots in the organisation.\n- `401 Unauthorized`: If the API key is invalid.\n- `404 Not Found`: If the campaign does not exist or is not associated with the organisation.","href":"/api-reference/endpoint/uploadContactToCampaign"},{"title":"Fetch Campaigns","openapi":"GET /api/v1/campaigns","href":"/api-reference/endpoint/fetchCampaigns"},{"title":"Start Campaign","openapi":"PUT /api/v1/campaigns/{campaign_id}/start","description":"Initiates a specified campaign, marking it as active and beginning the exchanges.\n\n ### Path Parameters\n\n - `organisation_id` (`int`): The ID of the organisation under which the campaign is registered.\n - `campaign_id` (`int`): The unique identifier of the campaign to be started.\n\n ### Headers\n\n- `X-API-Key`: API key for user authentication.\n\n ### Response\n\n - Returns a confirmation message indicating that the campaign has been successfully started and will begin its operations imminently.\n\n ### Errors\n\n - `400 Bad Request`: If the campaign cannot be started due to missing or invalid campaign settings.\n - `403 Forbidden`: If the user making the request does not have the necessary permissions to start the campaign.\n - `404 Not Found`: The campaign does not belong to the specified organisation.","href":"/api-reference/endpoint/startCampaign"},{"title":"Fetch Contact Status","openapi":"GET /api/v1/campaigns/data/replies","href":"/api-reference/endpoint/fetchCampaignContactStatus"},{"title":"Fetch Email Exchange","openapi":"GET /api/v1/exchanges/{exchange_id}/emails","href":"/api-reference/endpoint/fetchEmailExchange"}]},{"group":"Meetings \u0026 Conversions","pages":[{"title":"Fetch Meetings","openapi":"GET /api/v1/meetings","href":"/api-reference/endpoint/fetchMeetings"},{"title":"Log Conversion","openapi":"POST /api/v2/conversions","href":"/api-reference/endpoint/insertConversion"}]},{"group":"Contacts","pages":[{"title":"Fetch Contacts","openapi":"GET /api/v1/contacts","href":"/api-reference/endpoint/fetchContacts"},{"title":"Add Contact","openapi":"POST /api/v1/contacts/add","href":"/api-reference/endpoint/uploadContact"},{"title":"Add Domain to DNC List","openapi":"POST /api/v1/dnc-domains/json","href":"/api-reference/endpoint/addDNCDomain"},{"title":"Add Contact to DNC List","openapi":"POST /api/v1/contacts/dnc/add","href":"/api-reference/endpoint/addDNC"}]},{"group":"AI SDRs","pages":[{"title":"Fetch AI SDRs","openapi":"GET /api/v1/bots","href":"/api-reference/endpoint/fetchAISDR"}]}]}]},"basePath":"","title":"Fetch Campaigns - ChaseLabs Docs","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}