Filters are applied to each request independently. Changing filters while paginating may result in gaps or overlaps in the result set. For consistent results, maintain the same filters throughout pagination.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Altur","colors":{"primary":"#0066FF","light":"#0066FF","dark":"#0066FF"},"logo":{"light":"https://mintcdn.com/altur/D4WthK6Jl2QiKslz/logo/light.svg?fit=max\u0026auto=format\u0026n=D4WthK6Jl2QiKslz\u0026q=85\u0026s=20f8f677ccc5d294c37dc46192e3ea74","dark":"https://mintcdn.com/altur/D4WthK6Jl2QiKslz/logo/dark.svg?fit=max\u0026auto=format\u0026n=D4WthK6Jl2QiKslz\u0026q=85\u0026s=bba6b7c061d8e259a4fd8c730fc5f443"},"favicon":"https://mintcdn.com/altur/D4WthK6Jl2QiKslz/favicon.png?fit=max\u0026auto=format\u0026n=D4WthK6Jl2QiKslz\u0026q=85\u0026s=f0a4001cb667a302a1c7450a03343056","background":{"decoration":"grid","color":{"light":"#FFFFFF","dark":"#0D1117"}},"navbar":{"links":[{"href":"https://altur.io/blog","label":"Blog"}],"primary":{"type":"button","label":"Open App","href":"https://app.altur.io"}},"footer":{"socials":{"github":"https://github.com/alturio","linkedin":"https://www.linkedin.com/company/alturio"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":"en/documentation/introduction"},{"language":"es","href":"es/documentation/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"altur","hasAudioNarration":false,"actualSubdomain":"altur","customDomains":["docs.altur.io"],"gitSource":{"type":"github","owner":"alturio","repo":"altur-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6acadd7e230feb32d3d87044","collectionId":"08760b2e-5011-4e9f-bbdb-a1a2190a0ad4","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6acadd7e230feb32d3d87044"},"entitlements":{},"buildId":"6acadd7e230feb32d3d87044","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"en","tag":"API Reference","count":28},{"language":"es","tag":"Referencia de API","count":28},{"language":"en","tag":"API Endpoints","count":20},{"language":"es","tag":"Endpoints de API","count":20},{"language":"en","tag":"Campaigns","count":12},{"language":"es","tag":"Campañas","count":12},{"language":"en","tag":"Webhooks","count":6},{"language":"es","tag":"Webhooks","count":6},{"language":"en","tag":"Webhook Events","count":5},{"language":"en","tag":"Documentation","count":5},{"language":"es","tag":"Eventos de Webhook","count":5},{"language":"es","tag":"Documentación","count":5},{"language":"en","tag":"EndUsers","count":4},{"language":"es","tag":"EndUsers","count":4},{"language":"en","tag":"Calls","count":3},{"language":"es","tag":"Introducción","count":3},{"language":"es","tag":"Llamadas","count":3},{"language":"en","tag":"Getting Started","count":2},{"language":"en","tag":"Messages","count":2},{"language":"es","tag":"Mensajes","count":2}]},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/api-reference/campaigns/retrieve-contacts","slug":"/en/api-reference/campaigns/retrieve-contacts","pageMetadata":{"title":"List Campaign Contacts","openapi":"GET /campaigns/{id}/contacts","description":"Returns the Campaign Contacts corresponding to the given identifier","href":"/en/api-reference/campaigns/retrieve-contacts"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns the Campaign Contacts corresponding to the given identifier\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Info,Tab,Tabs}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Rate Limit:`}),` 12 requests per second`]})}),`\n`,_jsx(Heading,{level:`2`,id:`status-values-by-campaign-type`,children:`Status Values by Campaign Type`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Phone Campaigns`,id:`phone-campaigns`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`queue`}),` — Contact is waiting in queue`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`sending`}),` — Call is being initiated`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`failed`}),` — Call failed to connect`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`retrying`}),` — Scheduled for retry`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`converted`}),` — Contact was converted`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`voicemail`}),` — Reached voicemail`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`answered`}),` — Call was answered`]}),`\n`]})}),_jsx(Tab,{title:`WhatsApp Campaigns`,id:`whatsapp-campaigns`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`queue`}),` — Message is queued`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`sending`}),` — Message is being sent`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`sent`}),` — Message was sent`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`delivered`}),` — Message was delivered`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`read`}),` — Message was read`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`accepted`}),` — Contact accepted`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`rejected`}),` — Contact rejected`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`failed`}),` — Message failed`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`retrying`}),` — Scheduled for retry`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`converted`}),` — Contact was converted`]}),`\n`]})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List Campaign Contacts","openapi":"GET /campaigns/{id}/contacts","description":"Returns the Campaign Contacts corresponding to the given identifier","href":"/en/api-reference/campaigns/retrieve-contacts"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Status Values by Campaign Type","slug":"status-values-by-campaign-type","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Returns the Campaign Contacts corresponding to the given identifier","parameters":["a54ebd78-0932-4e65-96a9-66b54a4d3a9f","a77ed317-8e54-4bed-a1e8-4d36f2173399","50b3ef35-2e8a-4656-8430-c765aa584950","adc828e7-4b06-48a6-9715-9000fccf8f39"],"responses":{"200":"6b8a2d38-9259-4121-8d71-9c407fba7aa0","400":"31642fac-3289-4f1b-b61f-03efcbdb244a","401":"8adab85e-1e25-4b93-9786-746bef1938f7","404":"13bc4628-9c2f-4b91-b271-bcb95d8352f3"},"method":"get","type":"path","servers":["c8d15ecb-4ef9-4af2-8da9-65bf53121690"],"security":["2abef093-c110-4cfb-9665-f370af43e5e8"],"path":"/campaigns/{id}/contacts","baseUrlOptions":["https://api.altur.io/api/v1.0"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"a54ebd78-0932-4e65-96a9-66b54a4d3a9f":{"name":"id","in":"path","description":"The identifier of the Campaign to return the Contacts","schema":{"type":"integer","isRequired":true,"description":"The identifier of the Campaign to return the Contacts","uniqueKey":"","typeLabel":"integer"},"required":true},"a77ed317-8e54-4bed-a1e8-4d36f2173399":{"name":"status","in":"query","description":"Filters the Campaign Contacts by the Status of the Campaign Contact","schema":{"type":"string","enum":["queue","sending","sent","delivered","voicemail","read","failed","retrying","converted","answered","accepted","rejected"],"isRequired":false,"description":"Filters the Campaign Contacts by the Status of the Campaign Contact","uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":false},"50b3ef35-2e8a-4656-8430-c765aa584950":{"name":"pageSize","in":"query","description":"Number of items per page to return.","schema":{"type":"integer","default":50,"minimum":1,"maximum":100,"isRequired":false,"description":"Number of items per page to return.","uniqueKey":"","typeLabel":"integer"},"required":false},"adc828e7-4b06-48a6-9715-9000fccf8f39":{"name":"pageIndex","in":"query","description":"Page number to the next page to return.","schema":{"type":"integer","default":0,"maximum":25000,"minimum":0,"isRequired":false,"description":"Page number to the next page to return.","uniqueKey":"","typeLabel":"integer"},"required":false}},"responses":{"6b8a2d38-9259-4121-8d71-9c407fba7aa0":{"description":"Campaign Contacts response","content":{"application/json":{"schema":{"type":"object","properties":{"total_count":{"description":"Total number of Campaign Contacts for the given query. NOTE: Only calculated in the first page.","type":"integer","uniqueKey":"total_count","typeLabel":"integer"},"contacts":{"type":"array","items":{"type":"object","properties":{"f_id":{"description":"Unique External identifier for the Campaign Contact","type":"string","uniqueKey":"contacts.items.[INDEX].f_id","typeLabel":"string"},"id":{"description":"Unique identifier for the Campaign Contact","type":"integer","uniqueKey":"contacts.items.[INDEX].id","typeLabel":"integer"},"name":{"description":"Name of the Campaign Contact","type":"string","uniqueKey":"contacts.items.[INDEX].name","typeLabel":"string"},"contact":{"description":"Phone number of the contact","type":"string","uniqueKey":"contacts.items.[INDEX].contact","typeLabel":"string"},"status":{"description":"Status of the Campaign Contact","type":"string","uniqueKey":"contacts.items.[INDEX].status","typeLabel":"string"},"context":{"description":"Context of the Campaign Contact","type":"string","uniqueKey":"contacts.items.[INDEX].context","typeLabel":"string"},"retries":{"description":"Voicemail retries of the Campaign Contact","type":"integer","uniqueKey":"contacts.items.[INDEX].retries","typeLabel":"integer"},"has_follow_up":{"description":"Boolean describing if the Campaign Contact has a follow up scheduled","type":"boolean","uniqueKey":"contacts.items.[INDEX].has_follow_up","typeLabel":"boolean"},"call_count":{"description":"Number of calls made to the Campaign Contact","type":"integer","uniqueKey":"contacts.items.[INDEX].call_count","typeLabel":"integer"},"billed_duration":{"description":"The total billed duration of the Campaign Contact Calls in seconds","type":"integer","example":270,"uniqueKey":"contacts.items.[INDEX].billed_duration","typeLabel":"integer"},"last_call_at":{"description":"The datetime of the last call made to the Campaign Contact","type":"string","example":"2025-10-03 19:11:39","uniqueKey":"contacts.items.[INDEX].last_call_at","typeLabel":"string"},"extracted_data":{"description":"Extracted data of the Campaign Contact","type":"object","example":{"monto_prometido":"1000","fecha_limite":"01-01-2025"},"uniqueKey":"contacts.items.[INDEX].extracted_data","typeLabel":"object"},"tags":{"description":"Tags assigned to the Campaign Contact","type":"array","items":{"type":"string","uniqueKey":"contacts.items.[INDEX].tags.items.[INDEX]","typeLabel":"string"},"example":["tag1","tag2"],"uniqueKey":"contacts.items.[INDEX].tags","typeLabel":"string[]"}},"uniqueKey":"contacts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"contacts","typeLabel":"object[]"},"pagination":{"type":"object","description":"Filters are applied to each request independently. Changing filters while paginating may result in gaps or overlaps in the result set. For consistent results, maintain the same filters throughout pagination.","properties":{"has_next":{"type":"boolean","description":"Boolean describing if there are more items to fetch","uniqueKey":"pagination.has_next","typeLabel":"boolean"},"has_previous":{"type":"boolean","description":"Boolean describing if there are previous items to fetch","uniqueKey":"pagination.has_previous","typeLabel":"boolean"},"next_page":{"type":"integer","description":"Page Index to the next page to return. Can be null if there are no more pages.","uniqueKey":"pagination.next_page","typeLabel":"integer"},"previous_page":{"type":"integer","description":"Page Index to the previous page to return. Can be null if there are no previous pages.","uniqueKey":"pagination.previous_page","typeLabel":"integer"}},"uniqueKey":"pagination","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"total_count":123,"contacts":[{"f_id":"\u003cstring>","id":123,"name":"\u003cstring>","contact":"\u003cstring>","status":"\u003cstring>","context":"\u003cstring>","retries":123,"has_follow_up":true,"call_count":123,"billed_duration":270,"last_call_at":"2025-10-03 19:11:39","extracted_data":{"monto_prometido":"1000","fecha_limite":"01-01-2025"},"tags":["tag1","tag2"]}],"pagination":{"has_next":true,"has_previous":true,"next_page":123,"previous_page":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"31642fac-3289-4f1b-b61f-03efcbdb244a":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","description":"Validation error response where each field name that has an error is a property containing an array of error messages","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additionalProperties","typeLabel":"string[]"},"example":{"field1":["This field is required."],"field2":["Incorrect format."],"non_field_errors":["The date range is not valid."]},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"field1":["This field is required."],"field2":["Incorrect format."],"non_field_errors":["The date range is not valid."]}}},"exampleType":"generated"}},"exampleType":"generated"},"8adab85e-1e25-4b93-9786-746bef1938f7":{"description":"Unauthorized","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"error":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"13bc4628-9c2f-4b91-b271-bcb95d8352f3":{"description":"Campaign not found","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"error":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"2abef093-c110-4cfb-9665-f370af43e5e8":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Add `api-key YOUR_API_SECRET_KEY` as the value of the `Authorization` header.","scopes":[]}}},"servers":{"c8d15ecb-4ef9-4af2-8da9-65bf53121690":{"url":"https://api.altur.io/api/v1.0"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Add `api-key YOUR_API_SECRET_KEY` as the value of the `Authorization` header.","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"Add `api-key YOUR_API_SECRET_KEY` as the value of the `Authorization` header.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"Authorization"}],"title":"apiKeyAuth"}]},"originalFileLocation":"en/api-reference/openapi.json"},"subdomain":"altur","siteName":"Altur","title":"List Campaign Contacts - Altur","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/api-reference/campaigns/retrieve-contacts","matchLevel":0},"es":{"href":"/es/api-reference/campaigns/retrieve-contacts","matchLevel":1}}},"lastModified":"2025-12-09T22:21:11.204Z","originalFileLocation":"en/api-reference/campaigns/retrieve-contacts.mdx","locale":"en"},"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=\"Returns the Campaign Contacts corresponding to the given identifier\">\u003cmeta data-mint-head name=\"application-name\" content=\"Altur\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/altur/-L_trUOSQMv2YyeK/_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/altur/-L_trUOSQMv2YyeK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/altur/-L_trUOSQMv2YyeK/_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/altur/-L_trUOSQMv2YyeK/_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/altur/-L_trUOSQMv2YyeK/_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/altur/-L_trUOSQMv2YyeK/_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/altur/-L_trUOSQMv2YyeK/_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/altur/-L_trUOSQMv2YyeK/_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/altur/-L_trUOSQMv2YyeK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Campaign Contacts - Altur\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the Campaign Contacts corresponding to the given identifier\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Altur\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.altur.io/en/api-reference/campaigns/retrieve-contacts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://altur.mintlify.app/_mintlify/api/og/v2?division=Campaigns\u0026amp;title=List+Campaign+Contacts\u0026amp;description=Returns+the+Campaign+Contacts+corresponding+to+the+given+identifier\u0026amp;theme=d457f886f343045339d35962\u0026amp;signature=881a336b0db5d555d2e3a3cce08d27553b5a7b2ce5bba3e8c0ceb8e4cc124e94\">\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=\"List Campaign Contacts - Altur\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the Campaign Contacts corresponding to the given identifier\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://altur.mintlify.app/_mintlify/api/og/v2?division=Campaigns\u0026amp;title=List+Campaign+Contacts\u0026amp;description=Returns+the+Campaign+Contacts+corresponding+to+the+given+identifier\u0026amp;theme=d457f886f343045339d35962\u0026amp;signature=881a336b0db5d555d2e3a3cce08d27553b5a7b2ce5bba3e8c0ceb8e4cc124e94\">\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/altur/-L_trUOSQMv2YyeK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Altur\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0066FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.altur.io/en/api-reference/campaigns/retrieve-contacts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/api-reference/campaigns/retrieve-contacts.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.altur.io/en/api-reference/campaigns/retrieve-contacts\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.altur.io/es/api-reference/campaigns/retrieve-contacts\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.altur.io/en/api-reference/campaigns/retrieve-contacts\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.altur.io/#organization\",\"name\":\"Altur\",\"url\":\"https://docs.altur.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/altur/D4WthK6Jl2QiKslz/logo/light.svg?fit=max\u0026auto=format\u0026n=D4WthK6Jl2QiKslz\u0026q=85\u0026s=20f8f677ccc5d294c37dc46192e3ea74\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.altur.io#website\",\"name\":\"Altur\",\"url\":\"https://docs.altur.io\",\"publisher\":{\"@id\":\"https://docs.altur.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.altur.io/en/api-reference/campaigns/retrieve-contacts#webpage\",\"url\":\"https://docs.altur.io/en/api-reference/campaigns/retrieve-contacts\",\"name\":\"List Campaign Contacts\",\"description\":\"Returns the Campaign Contacts corresponding to the given identifier\",\"dateModified\":\"2025-12-09T22:21:11.204Z\",\"isPartOf\":{\"@id\":\"https://docs.altur.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.altur.io/en/api-reference/campaigns/retrieve-contacts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.altur.io/en/api-reference/campaigns/retrieve-contacts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Endpoints\",\"item\":\"https://docs.altur.io/en/api-reference/calls/start\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Campaigns\",\"item\":\"https://docs.altur.io/en/api-reference/campaigns/retrieve\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List Campaign Contacts\",\"item\":\"https://docs.altur.io/en/api-reference/campaigns/retrieve-contacts\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.altur.io/en/api-reference/campaigns/retrieve-contacts#apireference\",\"headline\":\"List Campaign Contacts\",\"name\":\"List Campaign Contacts\",\"description\":\"Returns the Campaign Contacts corresponding to the given identifier\",\"url\":\"https://docs.altur.io/en/api-reference/campaigns/retrieve-contacts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.altur.io/en/api-reference/campaigns/retrieve-contacts#webpage\"},\"dateModified\":\"2025-12-09T22:21:11.204Z\",\"publisher\":{\"@id\":\"https://docs.altur.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.altur.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Altur\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Altur","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/en/documentation/introduction"}]},{"tab":"API Reference","groups":[{"group":"Getting Started","pages":[{"title":"API Overview","href":"/en/api-reference/introduction"},{"title":"Authentication","href":"/en/api-reference/authentication"}]},{"group":"API Endpoints","pages":[{"group":"Calls","icon":"phone","pages":[{"title":"Start Call","openapi":"POST /call","href":"/en/api-reference/calls/start"},{"title":"Retrieve Call","openapi":"GET /call/{id}","href":"/en/api-reference/calls/retrieve"},{"title":"Retrieve Call Recording","openapi":"GET /call/{id}/recording","href":"/en/api-reference/calls/retrieve-recording"}]},{"group":"Campaigns","icon":"megaphone","pages":[{"title":"List Campaigns","openapi":"GET /campaigns","href":"/en/api-reference/campaigns/retrieve"},{"title":"Retrieve Campaign","openapi":"GET /campaigns/{id}","href":"/en/api-reference/campaigns/retrieve-detail"},{"title":"Create Campaign","openapi":"POST /campaigns","href":"/en/api-reference/campaigns/create"},{"title":"Update Campaign","openapi":"PATCH /campaigns/{id}","href":"/en/api-reference/campaigns/update"},{"title":"Lifecycle Actions","openapi":"POST /campaigns/{id}/{action}","description":"Aplica una acción de ciclo de vida a una Campaña. Acciones válidas: `activate`, `pause`, `archive`, `resume`. La acción es idempotente: aplicar una acción cuando la campaña ya está en el estado destino es un no-op exitoso.","href":"/en/api-reference/campaigns/lifecycle"},{"title":"List Campaign Contacts","openapi":"GET /campaigns/{id}/contacts","href":"/en/api-reference/campaigns/retrieve-contacts"},{"title":"Add Contacts to Campaign","openapi":"POST /campaigns/{id}/contacts","description":"Crea Contactos de Campaña por lotes. Hasta 1000 contactos por solicitud. Cada item se procesa de forma independiente (una fila inválida no rompe el lote) y se devuelve un `summary` agregado y `results` por item. Usa `if_duplicate` para controlar el comportamiento cuando un contacto ya existe en la campaña (`skip` mantiene el original, `update` sobreescribe los campos mutables).","href":"/en/api-reference/campaigns/create-contacts"},{"title":"Retrieve Campaign Contact","openapi":"GET /campaigns/{id}/contacts/{contact_id}","href":"/en/api-reference/campaigns/retrieve-contact"},{"title":"Delete Campaign Contact","openapi":"DELETE /campaigns/{id}/contacts/{contact_id}","href":"/en/api-reference/campaigns/delete-contact"},{"title":"List Campaign Calls","openapi":"GET /campaigns/{id}/calls","href":"/en/api-reference/campaigns/retrieve-calls"}]},{"group":"Messages","icon":"message","pages":[{"title":"Send Message","openapi":"POST /message","href":"/en/api-reference/messages/send"},{"title":"Get Messages","openapi":"GET /message/{thread_id}","href":"/en/api-reference/messages/retrieve"}]},{"group":"Threads","icon":"messages","pages":[{"title":"Retrieve Thread","openapi":"GET /thread/{id}","href":"/en/api-reference/threads/retrieve"}]},{"group":"EndUsers","icon":"user","pages":[{"title":"Create EndUser","openapi":"POST /enduser","href":"/en/api-reference/endusers/create"},{"title":"Retrieve EndUser","openapi":"GET /enduser/{id}","href":"/en/api-reference/endusers/retrieve"},{"title":"Update EndUser","openapi":"PUT /enduser/{id}","href":"/en/api-reference/endusers/update"},{"title":"Delete EndUser","openapi":"DELETE /enduser/{id}","href":"/en/api-reference/endusers/delete"}]}]},{"group":"Webhooks","pages":[{"title":"Webhooks Overview","icon":"webhook","iconType":"regular","href":"/en/api-reference/webhooks/overview"},{"group":"Webhook Events","icon":"bolt","pages":[{"title":"on_call_end","href":"/en/api-reference/webhooks/on-call-end"},{"title":"transfer_started","href":"/en/api-reference/webhooks/transfer-started"},{"title":"transfer_completed","href":"/en/api-reference/webhooks/transfer-completed"},{"title":"campaign.status_changed","href":"/en/api-reference/webhooks/campaign-status-changed"},{"title":"campaign.cycle_completed","href":"/en/api-reference/webhooks/campaign-cycle-completed"}]}]}]}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/campaigns/retrieve-contacts"}]}]},"title":"List Campaign Contacts - Altur","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}