Seniority bands the persona rejects, judged the same way. A person whose title falls into one of these is dropped even when it also matches seniority_includes. A title carrying no seniority signal is kept, so this never removes the unclassified.
Keyword expression the persona narrows its searches by, matched against the whole LinkedIn profile (headline, About, every role and its description, skills). Null when the persona has none. Applied by People search whenever this persona is used, so a search scoped to this persona returns only people whose profile text matches.
Languages the person's LinkedIn profile is written in (ISO 639-1: en, fr, de, es, it, nl, pt), ORed. Empty when the persona has no language filter. Applied by People search whenever this persona is used.
Example:
["en"]
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"TAMTAM","colors":{"primary":"#0c31c1","light":"#3554d4","dark":"#081f7a"},"logo":{"light":"https://mintcdn.com/tamtam/1lHFBYsUpWvVAToh/assets/logo/light.svg?fit=max\u0026auto=format\u0026n=1lHFBYsUpWvVAToh\u0026q=85\u0026s=5291cd6148923d32a8552bdb99ef3669","dark":"https://mintcdn.com/tamtam/1lHFBYsUpWvVAToh/assets/logo/dark.svg?fit=max\u0026auto=format\u0026n=1lHFBYsUpWvVAToh\u0026q=85\u0026s=32b84eb16f13c1a361f8318778532924"},"favicon":"https://mintcdn.com/tamtam/1lHFBYsUpWvVAToh/assets/favicon.png?fit=max\u0026auto=format\u0026n=1lHFBYsUpWvVAToh\u0026q=85\u0026s=f532f912a05f0bdb216d0903aae60d4a","navbar":{"links":[],"primary":{"type":"button","label":"Visit tamtam.ai","href":"https://www.tamtam.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/tamtam-ai"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tamtam","hasAudioNarration":false,"actualSubdomain":"tamtam","customDomains":["docs.api.tamtam.ai"],"gitSource":{"type":"gitlab","owner":"tamtamai","repo":"tamtam","projectId":76070796,"deployBranch":"production","contentDirectory":"backend/public-api/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae36362864324a0b7688ac3","collectionId":"60ec3be8-4567-4986-a371-38355385382b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae36362864324a0b7688ac3"},"entitlements":{},"buildId":"6ae498f016d886c98de48553","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API reference","count":88},{"language":"default","tag":"Signals","count":11},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Companies","count":7},{"language":"default","tag":"People Search","count":7},{"language":"default","tag":"LinkedIn Content Signals","count":6},{"language":"default","tag":"Smart Verticals","count":6},{"language":"default","tag":"Webhooks","count":6},{"language":"default","tag":"Concepts","count":5},{"language":"default","tag":"Contact Searches","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/personas/list-personas","slug":"/api-reference/personas/list-personas","pageMetadata":{"title":"List personas","description":"List all active personas for the authenticated account.","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/personas","href":"/api-reference/personas/list-personas","autogeneratedByOpenApi":true},"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: \"List all active personas for the authenticated account.\"\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":"List personas","description":"List all active personas for the authenticated account.","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/personas","href":"/api-reference/personas/list-personas","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"List all active personas for the authenticated account.","operationId":"get-personas","responses":{"200":"1eb96919-b836-4aad-8e78-f9c9cb4c9943","default":"fd13496b-9977-4b84-b87b-a3047c3eca69"},"security":["6f674e3c-9f64-4bef-a4c3-2046088baf6a","7c0c754d-1dfb-4dbe-819c-6368646368d7"],"summary":"List personas","tags":["Personas"],"method":"get","type":"path","servers":["83ce9b4e-1db5-4c96-8b86-10e3c4245028"],"path":"/v2/personas","baseUrlOptions":["https://api.tamtam.ai/api"],"title":"List personas","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"1eb96919-b836-4aad-8e78-f9c9cb4c9943":{"content":{"application/json":{"schema":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"canonical_job_titles_excludes":{"oneOf":[{"description":"Canonical job titles the persona rejects, resolved to their labels","items":{"additionalProperties":false,"properties":{"id":{"description":"Canonical job title ID. Pass it to People search as canonical_job_titles_includes_ids.","examples":["b3c6f5e2-1234-4abc-9def-0123456789ab"],"type":"string","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_excludes.oneOf.0.items.[INDEX].id","typeLabel":"string"},"title":{"description":"English label of the canonical job title","examples":["Head of Sales"],"type":"string","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_excludes.oneOf.0.items.[INDEX].title","typeLabel":"string"},"acronym":{"description":"Common acronym for the title, when one exists","examples":["CRO"],"type":"string","uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_excludes.oneOf.0.items.[INDEX].acronym","typeLabel":"string"},"function":{"description":"Business function the title belongs to, when known","examples":["Sales"],"type":"string","uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_excludes.oneOf.0.items.[INDEX].function","typeLabel":"string"}},"required":["id","title"],"type":"object","uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_excludes.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_excludes.oneOf.0","typeLabel":"object[]"},{"description":"Canonical job titles the persona rejects, resolved to their labels","items":{"additionalProperties":false,"properties":{"acronym":{"description":"Common acronym for the title, when one exists","examples":["CRO"],"type":"string"},"function":{"description":"Business function the title belongs to, when known","examples":["Sales"],"type":"string"},"id":{"description":"Canonical job title ID. Pass it to People search as canonical_job_titles_includes_ids.","examples":["b3c6f5e2-1234-4abc-9def-0123456789ab"],"type":"string"},"title":{"description":"English label of the canonical job title","examples":["Head of Sales"],"type":"string"}},"required":["id","title"],"type":"object"},"type":"null","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_excludes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_excludes","typeLabel":"object[] | null"},"canonical_job_titles_includes":{"oneOf":[{"description":"Canonical job titles the persona matches, resolved to their labels","items":{"additionalProperties":false,"properties":{"id":{"description":"Canonical job title ID. Pass it to People search as canonical_job_titles_includes_ids.","examples":["b3c6f5e2-1234-4abc-9def-0123456789ab"],"type":"string","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_includes.oneOf.0.items.[INDEX].id","typeLabel":"string"},"title":{"description":"English label of the canonical job title","examples":["Head of Sales"],"type":"string","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_includes.oneOf.0.items.[INDEX].title","typeLabel":"string"},"acronym":{"description":"Common acronym for the title, when one exists","examples":["CRO"],"type":"string","uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_includes.oneOf.0.items.[INDEX].acronym","typeLabel":"string"},"function":{"description":"Business function the title belongs to, when known","examples":["Sales"],"type":"string","uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_includes.oneOf.0.items.[INDEX].function","typeLabel":"string"}},"required":["id","title"],"type":"object","uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_includes.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_includes.oneOf.0","typeLabel":"object[]"},{"description":"Canonical job titles the persona matches, resolved to their labels","items":{"additionalProperties":false,"properties":{"acronym":{"description":"Common acronym for the title, when one exists","examples":["CRO"],"type":"string"},"function":{"description":"Business function the title belongs to, when known","examples":["Sales"],"type":"string"},"id":{"description":"Canonical job title ID. Pass it to People search as canonical_job_titles_includes_ids.","examples":["b3c6f5e2-1234-4abc-9def-0123456789ab"],"type":"string"},"title":{"description":"English label of the canonical job title","examples":["Head of Sales"],"type":"string"}},"required":["id","title"],"type":"object"},"type":"null","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_includes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].canonical_job_titles_includes","typeLabel":"object[] | null"},"countries":{"oneOf":[{"description":"Country codes the persona is scoped to","examples":[["FR"]],"items":{"type":"string","uniqueKey":"oneOf.0.items.[INDEX].countries.oneOf.0.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].countries.oneOf.0","typeLabel":"string[]"},{"description":"Country codes the persona is scoped to","examples":[["FR"]],"items":{"type":"string"},"type":"null","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].countries.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].countries","typeLabel":"string[] | null"},"country_excludes":{"oneOf":[{"description":"Country codes the persona excludes","examples":[["BE"]],"items":{"type":"string","uniqueKey":"oneOf.0.items.[INDEX].country_excludes.oneOf.0.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].country_excludes.oneOf.0","typeLabel":"string[]"},{"description":"Country codes the persona excludes","examples":[["BE"]],"items":{"type":"string"},"type":"null","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].country_excludes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].country_excludes","typeLabel":"string[] | null"},"criteria_only":{"description":"True when the persona exists only to drive scoring criteria. Such a persona defines no people search and is rejected by People search's persona_id.","examples":[false],"type":"boolean","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].criteria_only","typeLabel":"boolean"},"id":{"description":"Persona UUID","examples":["b3c6f5e2-1234-4abc-9def-0123456789ab"],"type":"string","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].id","typeLabel":"string"},"job_titles_excludes":{"oneOf":[{"description":"Free-text job titles the persona rejects","examples":[["Intern"]],"items":{"type":"string","uniqueKey":"oneOf.0.items.[INDEX].job_titles_excludes.oneOf.0.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].job_titles_excludes.oneOf.0","typeLabel":"string[]"},{"description":"Free-text job titles the persona rejects","examples":[["Intern"]],"items":{"type":"string"},"type":"null","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].job_titles_excludes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].job_titles_excludes","typeLabel":"string[] | null"},"job_titles_includes":{"oneOf":[{"description":"Free-text job titles the persona matches","examples":[["Head of Sales"]],"items":{"type":"string","uniqueKey":"oneOf.0.items.[INDEX].job_titles_includes.oneOf.0.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].job_titles_includes.oneOf.0","typeLabel":"string[]"},{"description":"Free-text job titles the persona matches","examples":[["Head of Sales"]],"items":{"type":"string"},"type":"null","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].job_titles_includes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].job_titles_includes","typeLabel":"string[] | null"},"name":{"description":"Persona name","examples":["Head of Sales — France"],"type":"string","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].name","typeLabel":"string"},"seniority_excludes":{"oneOf":[{"description":"Seniority bands the persona rejects, judged the same way. A person whose title falls into one of these is dropped even when it also matches seniority_includes. A title carrying no seniority signal is kept, so this never removes the unclassified.","examples":[["In Training"]],"items":{"type":"string","uniqueKey":"oneOf.0.items.[INDEX].seniority_excludes.oneOf.0.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].seniority_excludes.oneOf.0","typeLabel":"string[]"},{"description":"Seniority bands the persona rejects, judged the same way. A person whose title falls into one of these is dropped even when it also matches seniority_includes. A title carrying no seniority signal is kept, so this never removes the unclassified.","examples":[["In Training"]],"items":{"type":"string"},"type":"null","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].seniority_excludes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].seniority_excludes","typeLabel":"string[] | null"},"seniority_includes":{"oneOf":[{"description":"Seniority bands the persona keeps, judged by Tamtam from the job title. Applied to fetched results, never sent to a search provider.","examples":[["Director"]],"items":{"type":"string","uniqueKey":"oneOf.0.items.[INDEX].seniority_includes.oneOf.0.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].seniority_includes.oneOf.0","typeLabel":"string[]"},{"description":"Seniority bands the persona keeps, judged by Tamtam from the job title. Applied to fetched results, never sent to a search provider.","examples":[["Director"]],"items":{"type":"string"},"type":"null","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].seniority_includes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].seniority_includes","typeLabel":"string[] | null"},"tier_level":{"description":"Priority tier the account assigned to this persona. Lower is more important.","examples":[1],"format":"int64","type":"integer","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].tier_level","typeLabel":"integer\u003cint64>"},"usages":{"oneOf":[{"description":"What the account uses this persona for. Effective values: 'prospecting', 'closing_deals'.","examples":[["prospecting"]],"items":{"type":"string","uniqueKey":"oneOf.0.items.[INDEX].usages.oneOf.0.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].usages.oneOf.0","typeLabel":"string[]"},{"description":"What the account uses this persona for. Effective values: 'prospecting', 'closing_deals'.","examples":[["prospecting"]],"items":{"type":"string"},"type":"null","isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].usages.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.items.[INDEX].usages","typeLabel":"string[] | null"},"profile_keywords":{"description":"Keyword expression the persona narrows its searches by, matched against the whole LinkedIn profile (headline, About, every role and its description, skills). Null when the persona has none. Applied by People search whenever this persona is used, so a search scoped to this persona returns only people whose profile text matches.","examples":["\"supply chain\" AND SAP"],"type":"string","uniqueKey":"oneOf.0.items.[INDEX].profile_keywords","typeLabel":"string"},"profile_languages":{"oneOf":[{"description":"Languages the person's LinkedIn profile is written in (ISO 639-1: en, fr, de, es, it, nl, pt), ORed. Empty when the persona has no language filter. Applied by People search whenever this persona is used.","examples":[["en"]],"items":{"type":"string","uniqueKey":"oneOf.0.items.[INDEX].profile_languages.oneOf.0.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"oneOf.0.items.[INDEX].profile_languages.oneOf.0","typeLabel":"string[]"},{"description":"Languages the person's LinkedIn profile is written in (ISO 639-1: en, fr, de, es, it, nl, pt), ORed. Empty when the persona has no language filter. Applied by People search whenever this persona is used.","examples":[["en"]],"items":{"type":"string"},"type":"null","uniqueKey":"oneOf.0.items.[INDEX].profile_languages.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.items.[INDEX].profile_languages","typeLabel":"string[] | null"}},"required":["id","name","tier_level","countries","country_excludes","job_titles_includes","job_titles_excludes","canonical_job_titles_includes","canonical_job_titles_excludes","seniority_includes","seniority_excludes","criteria_only","usages"],"type":"object","uniqueKey":"oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"oneOf.0","typeLabel":"object[]"},{"items":{"additionalProperties":false,"properties":{"canonical_job_titles_excludes":{"oneOf":[{"description":"Canonical job titles the persona rejects, resolved to their labels","items":{"additionalProperties":false,"properties":{"acronym":{"description":"Common acronym for the title, when one exists","examples":["CRO"],"type":"string"},"function":{"description":"Business function the title belongs to, when known","examples":["Sales"],"type":"string"},"id":{"description":"Canonical job title ID. Pass it to People search as canonical_job_titles_includes_ids.","examples":["b3c6f5e2-1234-4abc-9def-0123456789ab"],"type":"string"},"title":{"description":"English label of the canonical job title","examples":["Head of Sales"],"type":"string"}},"required":["id","title"],"type":"object"},"type":"array"},{"description":"Canonical job titles the persona rejects, resolved to their labels","items":{"additionalProperties":false,"properties":{"acronym":{"description":"Common acronym for the title, when one exists","examples":["CRO"],"type":"string"},"function":{"description":"Business function the title belongs to, when known","examples":["Sales"],"type":"string"},"id":{"description":"Canonical job title ID. Pass it to People search as canonical_job_titles_includes_ids.","examples":["b3c6f5e2-1234-4abc-9def-0123456789ab"],"type":"string"},"title":{"description":"English label of the canonical job title","examples":["Head of Sales"],"type":"string"}},"required":["id","title"],"type":"object"},"type":"null"}]},"canonical_job_titles_includes":{"oneOf":[{"description":"Canonical job titles the persona matches, resolved to their labels","items":{"additionalProperties":false,"properties":{"acronym":{"description":"Common acronym for the title, when one exists","examples":["CRO"],"type":"string"},"function":{"description":"Business function the title belongs to, when known","examples":["Sales"],"type":"string"},"id":{"description":"Canonical job title ID. Pass it to People search as canonical_job_titles_includes_ids.","examples":["b3c6f5e2-1234-4abc-9def-0123456789ab"],"type":"string"},"title":{"description":"English label of the canonical job title","examples":["Head of Sales"],"type":"string"}},"required":["id","title"],"type":"object"},"type":"array"},{"description":"Canonical job titles the persona matches, resolved to their labels","items":{"additionalProperties":false,"properties":{"acronym":{"description":"Common acronym for the title, when one exists","examples":["CRO"],"type":"string"},"function":{"description":"Business function the title belongs to, when known","examples":["Sales"],"type":"string"},"id":{"description":"Canonical job title ID. Pass it to People search as canonical_job_titles_includes_ids.","examples":["b3c6f5e2-1234-4abc-9def-0123456789ab"],"type":"string"},"title":{"description":"English label of the canonical job title","examples":["Head of Sales"],"type":"string"}},"required":["id","title"],"type":"object"},"type":"null"}]},"countries":{"oneOf":[{"description":"Country codes the persona is scoped to","examples":[["FR"]],"items":{"type":"string"},"type":"array"},{"description":"Country codes the persona is scoped to","examples":[["FR"]],"items":{"type":"string"},"type":"null"}]},"country_excludes":{"oneOf":[{"description":"Country codes the persona excludes","examples":[["BE"]],"items":{"type":"string"},"type":"array"},{"description":"Country codes the persona excludes","examples":[["BE"]],"items":{"type":"string"},"type":"null"}]},"criteria_only":{"description":"True when the persona exists only to drive scoring criteria. Such a persona defines no people search and is rejected by People search's persona_id.","examples":[false],"type":"boolean"},"id":{"description":"Persona UUID","examples":["b3c6f5e2-1234-4abc-9def-0123456789ab"],"type":"string"},"job_titles_excludes":{"oneOf":[{"description":"Free-text job titles the persona rejects","examples":[["Intern"]],"items":{"type":"string"},"type":"array"},{"description":"Free-text job titles the persona rejects","examples":[["Intern"]],"items":{"type":"string"},"type":"null"}]},"job_titles_includes":{"oneOf":[{"description":"Free-text job titles the persona matches","examples":[["Head of Sales"]],"items":{"type":"string"},"type":"array"},{"description":"Free-text job titles the persona matches","examples":[["Head of Sales"]],"items":{"type":"string"},"type":"null"}]},"name":{"description":"Persona name","examples":["Head of Sales — France"],"type":"string"},"profile_keywords":{"description":"Keyword expression the persona narrows its searches by, matched against the whole LinkedIn profile (headline, About, every role and its description, skills). Null when the persona has none. Applied by People search whenever this persona is used, so a search scoped to this persona returns only people whose profile text matches.","examples":["\"supply chain\" AND SAP"],"type":"string"},"profile_languages":{"oneOf":[{"description":"Languages the person's LinkedIn profile is written in (ISO 639-1: en, fr, de, es, it, nl, pt), ORed. Empty when the persona has no language filter. Applied by People search whenever this persona is used.","examples":[["en"]],"items":{"type":"string"},"type":"array"},{"description":"Languages the person's LinkedIn profile is written in (ISO 639-1: en, fr, de, es, it, nl, pt), ORed. Empty when the persona has no language filter. Applied by People search whenever this persona is used.","examples":[["en"]],"items":{"type":"string"},"type":"null"}]},"seniority_excludes":{"oneOf":[{"description":"Seniority bands the persona rejects, judged the same way. A person whose title falls into one of these is dropped even when it also matches seniority_includes. A title carrying no seniority signal is kept, so this never removes the unclassified.","examples":[["In Training"]],"items":{"type":"string"},"type":"array"},{"description":"Seniority bands the persona rejects, judged the same way. A person whose title falls into one of these is dropped even when it also matches seniority_includes. A title carrying no seniority signal is kept, so this never removes the unclassified.","examples":[["In Training"]],"items":{"type":"string"},"type":"null"}]},"seniority_includes":{"oneOf":[{"description":"Seniority bands the persona keeps, judged by Tamtam from the job title. Applied to fetched results, never sent to a search provider.","examples":[["Director"]],"items":{"type":"string"},"type":"array"},{"description":"Seniority bands the persona keeps, judged by Tamtam from the job title. Applied to fetched results, never sent to a search provider.","examples":[["Director"]],"items":{"type":"string"},"type":"null"}]},"tier_level":{"description":"Priority tier the account assigned to this persona. Lower is more important.","examples":[1],"format":"int64","type":"integer"},"usages":{"oneOf":[{"description":"What the account uses this persona for. Effective values: 'prospecting', 'closing_deals'.","examples":[["prospecting"]],"items":{"type":"string"},"type":"array"},{"description":"What the account uses this persona for. Effective values: 'prospecting', 'closing_deals'.","examples":[["prospecting"]],"items":{"type":"string"},"type":"null"}]}},"required":["id","name","tier_level","countries","country_excludes","job_titles_includes","job_titles_excludes","canonical_job_titles_includes","canonical_job_titles_excludes","seniority_includes","seniority_excludes","criteria_only","usages"],"type":"object"},"type":"null","uniqueKey":"oneOf.1","typeLabel":"null"}],"uniqueKey":"","typeLabel":"object[] | null"},"examples":{"Example":{"title":"Example","value":[{"canonical_job_titles_excludes":[{"id":"b3c6f5e2-1234-4abc-9def-0123456789ab","title":"Head of Sales","acronym":"CRO","function":"Sales"}],"canonical_job_titles_includes":[{"id":"b3c6f5e2-1234-4abc-9def-0123456789ab","title":"Head of Sales","acronym":"CRO","function":"Sales"}],"countries":["FR"],"country_excludes":["BE"],"criteria_only":false,"id":"b3c6f5e2-1234-4abc-9def-0123456789ab","job_titles_excludes":["Intern"],"job_titles_includes":["Head of Sales"],"name":"Head of Sales — France","seniority_excludes":["In Training"],"seniority_includes":["Director"],"tier_level":1,"usages":["prospecting"],"profile_keywords":"\"supply chain\" AND SAP","profile_languages":["en"]}]}},"exampleType":"generated"}},"description":"OK","exampleType":"generated"},"fd13496b-9977-4b84-b87b-a3047c3eca69":{"content":{"application/problem+json":{"schema":{"additionalProperties":false,"properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","examples":["Property foo is required but is missing."],"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"description":"Optional list of individual error details","items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.oneOf.0.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"description":"Optional list of individual error details","items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string"},"message":{"description":"Error message text","type":"string"},"value":{"description":"The value at the given location"}},"type":"object"},"type":"null","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","examples":["https://example.com/error-log/abc123"],"format":"uri","type":"string","uniqueKey":"instance","typeLabel":"string\u003curi>"},"status":{"description":"HTTP status code","examples":[400],"format":"int64","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint64>"},"title":{"description":"A short, human-readable summary of the problem type. This value should not change between occurrences of the error.","examples":["Bad Request"],"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"default":"about:blank","description":"A URI reference to human-readable documentation for the error.","examples":["https://example.com/errors/example"],"format":"uri","type":"string","uniqueKey":"type","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"Property foo is required but is missing.","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}],"instance":"https://example.com/error-log/abc123","status":400,"title":"Bad Request","type":"https://example.com/errors/example"}}},"exampleType":"generated"}},"description":"Error","exampleType":"generated"}},"security":{"6f674e3c-9f64-4bef-a4c3-2046088baf6a":{"apikeyAuth":{"description":"Account API key passed in the Authorization header","in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"apikeyAuth"}},"7c0c754d-1dfb-4dbe-819c-6368646368d7":{"bearerAuth":{"description":"Bearer JWT obtained via the OAuth 2.1 authorization flow","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"83ce9b4e-1db5-4c96-8b86-10e3c4245028":{"url":"https://api.tamtam.ai/api"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Account API key passed in the Authorization header","in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"apikeyAuth"},"schema":{"title":"Authorization","type":"string","description":"Account API key passed in the Authorization header","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apikeyAuth","name":"Authorization"}],"title":"apikeyAuth"},{"schemes":[{"scheme":{"description":"Bearer JWT obtained via the OAuth 2.1 authorization flow","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer JWT obtained via the OAuth 2.1 authorization flow","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"reference/openapi.yaml"},"subdomain":"tamtam","siteName":"TAMTAM","title":"List personas - TAMTAM","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T15:16:59.957Z","originalFileLocation":"api-reference/personas/list-personas.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=\"List all active personas for the authenticated account.\">\u003cmeta data-mint-head name=\"application-name\" content=\"TAMTAM\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List personas - TAMTAM\">\u003cmeta data-mint-head property=\"og:description\" content=\"List all active personas for the authenticated account.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TAMTAM\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.api.tamtam.ai/api-reference/personas/list-personas\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tamtam.mintlify.app/_mintlify/api/og/v2?division=Personas\u0026amp;title=List+personas\u0026amp;description=List+all+active+personas+for+the+authenticated+account.\u0026amp;theme=0a3840a452825963dbf5c1f1\u0026amp;signature=b3e38ca5e88a458417b0410b84459c2c5b95e4df3f2f856f7f80fc1b46d3c49f\">\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 personas - TAMTAM\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List all active personas for the authenticated account.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tamtam.mintlify.app/_mintlify/api/og/v2?division=Personas\u0026amp;title=List+personas\u0026amp;description=List+all+active+personas+for+the+authenticated+account.\u0026amp;theme=0a3840a452825963dbf5c1f1\u0026amp;signature=b3e38ca5e88a458417b0410b84459c2c5b95e4df3f2f856f7f80fc1b46d3c49f\">\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/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TAMTAM\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0c31c1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.api.tamtam.ai/api-reference/personas/list-personas\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/personas/list-personas.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.api.tamtam.ai/#organization\",\"name\":\"TAMTAM\",\"url\":\"https://docs.api.tamtam.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tamtam/1lHFBYsUpWvVAToh/assets/logo/light.svg?fit=max\u0026auto=format\u0026n=1lHFBYsUpWvVAToh\u0026q=85\u0026s=5291cd6148923d32a8552bdb99ef3669\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.api.tamtam.ai#website\",\"name\":\"TAMTAM\",\"url\":\"https://docs.api.tamtam.ai\",\"publisher\":{\"@id\":\"https://docs.api.tamtam.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.api.tamtam.ai/api-reference/personas/list-personas#webpage\",\"url\":\"https://docs.api.tamtam.ai/api-reference/personas/list-personas\",\"name\":\"List personas\",\"description\":\"List all active personas for the authenticated account.\",\"dateModified\":\"2026-10-29T15:16:59.957Z\",\"isPartOf\":{\"@id\":\"https://docs.api.tamtam.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.api.tamtam.ai/api-reference/personas/list-personas#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.api.tamtam.ai/api-reference/personas/list-personas#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"TAMTAM\",\"item\":\"https://docs.api.tamtam.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List personas\",\"item\":\"https://docs.api.tamtam.ai/api-reference/personas/list-personas\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.api.tamtam.ai/api-reference/personas/list-personas#apireference\",\"headline\":\"List personas\",\"name\":\"List personas\",\"description\":\"List all active personas for the authenticated account.\",\"url\":\"https://docs.api.tamtam.ai/api-reference/personas/list-personas\",\"mainEntityOfPage\":{\"@id\":\"https://docs.api.tamtam.ai/api-reference/personas/list-personas#webpage\"},\"dateModified\":\"2026-10-29T15:16:59.957Z\",\"publisher\":{\"@id\":\"https://docs.api.tamtam.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.api.tamtam.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TAMTAM\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"TAMTAM","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Contacts","pages":[{"title":"Get contacts by IDs (deprecated)","deprecated":true,"version":null,"openapi":"/reference/openapi.yaml post /v1/contacts","href":"/api-reference/contacts/get-contacts-by-ids-deprecated"},{"title":"Get contacts","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts","href":"/api-reference/contacts/get-contacts"},{"title":"Get research answers for a contact","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts/{contactID}/research-questions","href":"/api-reference/contacts/get-research-answers-for-a-contact"},{"title":"Ask a research question about a contact","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/contacts/{contactID}/research-questions","href":"/api-reference/contacts/ask-a-research-question-about-a-contact"}]},{"group":"Companies Lists","pages":[{"title":"List companies lists","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies-lists","href":"/api-reference/companies-lists/list-companies-lists"},{"title":"Get a companies list","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies-lists/{listID}","href":"/api-reference/companies-lists/get-a-companies-list"},{"title":"Add companies to a list","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies-lists/{listID}","href":"/api-reference/companies-lists/add-companies-to-a-list"}]},{"group":"Companies","pages":[{"title":"List job changes for companies","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies/job-changes","href":"/api-reference/companies/list-job-changes-for-companies"},{"title":"Search for a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies/search","href":"/api-reference/companies/search-for-a-company"},{"title":"Get job postings for a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies/{linkedin_id}/job-postings","href":"/api-reference/companies/get-job-postings-for-a-company"},{"title":"Get news for a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies/{linkedin_id}/news","href":"/api-reference/companies/get-news-for-a-company"},{"title":"Get research answers for a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies/{linkedin_id}/research-questions","href":"/api-reference/companies/get-research-answers-for-a-company"},{"title":"Ask a research question about a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies/{linkedin_id}/research-questions","href":"/api-reference/companies/ask-a-research-question-about-a-company"},{"title":"Get an asked research question","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies/{linkedin_id}/research-questions/{questionID}","href":"/api-reference/companies/get-an-asked-research-question"}]},{"group":"Contact Searches","pages":[{"title":"List contact searches","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contact-searches","href":"/api-reference/contact-searches/list-contact-searches"},{"title":"Start a contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/contact-searches","href":"/api-reference/contact-searches/start-a-contact-search"},{"title":"Preview a contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/contact-searches/preview-count","href":"/api-reference/contact-searches/preview-a-contact-search"},{"title":"Get a contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contact-searches/{searchID}","href":"/api-reference/contact-searches/get-a-contact-search"},{"title":"Stop a contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/contact-searches/{searchID}/stop","href":"/api-reference/contact-searches/stop-a-contact-search"}]},{"group":"Contacts Lists","pages":[{"title":"List contacts lists","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts-lists","href":"/api-reference/contacts-lists/list-contacts-lists"},{"title":"Get a contacts list","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts-lists/{contactsListID}","href":"/api-reference/contacts-lists/get-a-contacts-list"},{"title":"List the contacts in a contacts list or contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts-lists/{contactsListID}/contacts","href":"/api-reference/contacts-lists/list-the-contacts-in-a-contacts-list-or-contact-search"}]},{"group":"Signals","pages":[{"title":"List signals on a contacts list","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts-lists/{listID}/signals","href":"/api-reference/signals/list-signals-on-a-contacts-list"},{"title":"List CRM deal stages","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/crm-deal-stages","href":"/api-reference/signals/list-crm-deal-stages"},{"title":"Create a deal stage lookalike signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/deal-stage-lookalike-signals","href":"/api-reference/signals/create-a-deal-stage-lookalike-signal"},{"title":"Create a job posting signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/job-posting-signals","href":"/api-reference/signals/create-a-job-posting-signal"},{"title":"Start a lead generation run","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/lead-generation-runs","href":"/api-reference/signals/start-a-lead-generation-run"},{"title":"Create a new hire signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/new-hire-signals","href":"/api-reference/signals/create-a-new-hire-signal"},{"title":"Create a news signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/news-content-signals","href":"/api-reference/signals/create-a-news-signal"},{"title":"Create a page follower signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/page-follower-signals","href":"/api-reference/signals/create-a-page-follower-signal"},{"title":"List page follower filter values","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/page-follower-signals/filter-values","href":"/api-reference/signals/list-page-follower-filter-values"},{"title":"Create an ex-customer move signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/past-company-move-signals","href":"/api-reference/signals/create-an-ex-customer-move-signal"},{"title":"List signals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/signals","href":"/api-reference/signals/list-signals"}]},{"group":"Credits","pages":[{"title":"Get remaining credits","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/credits","href":"/api-reference/credits/get-remaining-credits"}]},{"group":"Engagement Watches","pages":[{"title":"List engagement signals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/engagement-signals","href":"/api-reference/engagement-watches/list-engagement-signals"},{"title":"List engagement watches","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/engagement-watches","href":"/api-reference/engagement-watches/list-engagement-watches"},{"title":"Create an engagement watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/engagement-watches","href":"/api-reference/engagement-watches/create-an-engagement-watch"},{"title":"Delete an engagement watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/engagement-watches/{id}","href":"/api-reference/engagement-watches/delete-an-engagement-watch"},{"title":"Update an engagement watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml patch /v2/engagement-watches/{id}","href":"/api-reference/engagement-watches/update-an-engagement-watch"}]},{"group":"ICP Criteria","pages":[{"title":"List ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-criteria","href":"/api-reference/icp-criteria/list-icp-criteria"},{"title":"Create an ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/icp-criteria","href":"/api-reference/icp-criteria/create-an-icp-criteria"},{"title":"Get an ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-criteria/{icpCriteriaID}","href":"/api-reference/icp-criteria/get-an-icp-criteria"},{"title":"Update an ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml put /v2/icp-criteria/{icpCriteriaID}","href":"/api-reference/icp-criteria/update-an-icp-criteria"},{"title":"Delete an ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/icp-criteria/{icpCriteriaID}","href":"/api-reference/icp-criteria/delete-an-icp-criteria"}]},{"group":"ICP Signal Watches","pages":[{"title":"List ICP signal watches","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-signal-watches","href":"/api-reference/icp-signal-watches/list-icp-signal-watches"},{"title":"Get an ICP signal watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-signal-watches/{icpCriteriaID}","href":"/api-reference/icp-signal-watches/get-an-icp-signal-watch"},{"title":"Create or update an ICP signal watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml put /v2/icp-signal-watches/{icpCriteriaID}","href":"/api-reference/icp-signal-watches/create-or-update-an-icp-signal-watch"},{"title":"Delete an ICP signal watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/icp-signal-watches/{icpCriteriaID}","href":"/api-reference/icp-signal-watches/delete-an-icp-signal-watch"},{"title":"List ICP signals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-signals","href":"/api-reference/icp-signal-watches/list-icp-signals"}]},{"group":"Industries","pages":[{"title":"Search industries","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/industries/search","href":"/api-reference/industries/search-industries"}]},{"group":"Key Accounts","pages":[{"title":"List Key Accounts","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/key-accounts","href":"/api-reference/key-accounts/list-key-accounts"},{"title":"Add companies to Key Accounts","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/key-accounts","href":"/api-reference/key-accounts/add-companies-to-key-accounts"}]},{"group":"Lead Score","pages":[{"title":"Score job titles at a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/lead-scores/at-company","href":"/api-reference/lead-score/score-job-titles-at-a-company"},{"title":"Score job titles with no company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/lead-scores/title-only","href":"/api-reference/lead-score/score-job-titles-with-no-company"}]},{"group":"LinkedIn Content Signals","pages":[{"title":"List content signal events","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/linkedin-content-signal-events","href":"/api-reference/linkedin-content-signals/list-content-signal-events"},{"title":"List LinkedIn content signals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/linkedin-content-signals","href":"/api-reference/linkedin-content-signals/list-linkedin-content-signals"},{"title":"Create a LinkedIn content signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/linkedin-content-signals","href":"/api-reference/linkedin-content-signals/create-a-linkedin-content-signal"},{"title":"Delete a LinkedIn content signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/linkedin-content-signals/{id}","href":"/api-reference/linkedin-content-signals/delete-a-linkedin-content-signal"},{"title":"Update a LinkedIn content signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml patch /v2/linkedin-content-signals/{id}","href":"/api-reference/linkedin-content-signals/update-a-linkedin-content-signal"},{"title":"List judged posts","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/linkedin-content-signals/{id}/posts","href":"/api-reference/linkedin-content-signals/list-judged-posts"}]},{"group":"Lookalikes","pages":[{"title":"Search for lookalike companies","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/multi-search-lookalikes","href":"/api-reference/lookalikes/search-for-lookalike-companies"}]},{"group":"People Enrichment","pages":[{"title":"Enrich people with email and phone data","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/enrich","href":"/api-reference/people-enrichment/enrich-people-with-email-and-phone-data"},{"title":"Get enrichment request status and results","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/people/enrich/{RequestID}","href":"/api-reference/people-enrichment/get-enrichment-request-status-and-results"}]},{"group":"People Extract","pages":[{"title":"Read people's experiences","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/experiences","href":"/api-reference/people-extract/read-peoples-experiences"},{"title":"Extract a person's profile","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/extract","href":"/api-reference/people-extract/extract-a-persons-profile"},{"title":"Resolve people to LinkedIn profiles","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/resolve","href":"/api-reference/people-extract/resolve-people-to-linkedin-profiles"}]},{"group":"People Search","pages":[{"title":"Search for people","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search","href":"/api-reference/people-search/search-for-people"},{"title":"Run a people search to the end in the background","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search-jobs","href":"/api-reference/people-search/run-a-people-search-to-the-end-in-the-background"},{"title":"Plan a large people search before running it","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search-jobs/plan","href":"/api-reference/people-search/plan-a-large-people-search-before-running-it"},{"title":"Get a people search job","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/people/search-jobs/{JobID}","href":"/api-reference/people-search/get-a-people-search-job"},{"title":"Read a people search job's results","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/people/search-jobs/{JobID}/results","href":"/api-reference/people-search/read-a-people-search-jobs-results"},{"title":"Run a planned people search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search-jobs/{JobID}/run","href":"/api-reference/people-search/run-a-planned-people-search"},{"title":"Stop a people search job","description":"Stop a running job. Pages already being fetched finish and are saved; no further page is bought. The job then ends as `stopped`, keeping what it saved. A job still planning cannot be stopped yet: 409, try again once it runs.","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search-jobs/{JobID}/stop","href":"/api-reference/people-search/stop-a-people-search-job"}]},{"group":"Personas","pages":[{"title":"List personas","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/personas","href":"/api-reference/personas/list-personas"},{"title":"Create a persona","description":"Create a persona: your saved definition of who you sell to, as job titles, seniority bands, countries and an optional profile keyword expression.\n\nPersonas drive people search across Tamtam — Contact Search, PipeGen, Key Contacts, job change alerts, the persona badges on lists — so a new one is available everywhere at once, and People search accepts its `id` as `persona_id`.\n\nAn omitted field takes the same default the settings editor applies. List personas first: if one already covers this audience, change it with [Update a persona](/api-reference/personas/update-a-persona) rather than creating a near-duplicate somebody then has to reconcile.\n\nAt least one job title is required (`job_titles_includes` or `canonical_job_titles_includes_ids`): seniority and countries only narrow, so a persona with no title would match every contact at every company.\n\nPrefer canonical IDs over free text — a canonical title searches every language LinkedIn localizes it into, while the same words typed as free text reach far fewer profiles. A free-text title that exactly names a canonical one is resolved for you and reported in `promoted_to_canonical`.\n\nReturns the saved persona in the [List personas](/api-reference/personas/list-personas) shape. `warnings` names anything that makes the persona work against itself: an exclude that cancels an included title, seniority bands that reject the band an included title names, a title too ambiguous to resolve, a seniority value that names no band. The persona is saved regardless.\n\nFree: no credits.","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/personas","href":"/api-reference/personas/create-a-persona"},{"title":"Update a persona","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml patch /v2/personas/{id}","href":"/api-reference/personas/update-a-persona"}]},{"group":"Smart Verticals","pages":[{"title":"List smart verticals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/smart-verticals","href":"/api-reference/smart-verticals/list-smart-verticals"},{"title":"Create a smart vertical","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/smart-verticals","href":"/api-reference/smart-verticals/create-a-smart-vertical"},{"title":"Classify companies into smart verticals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/smart-verticals/classify","href":"/api-reference/smart-verticals/classify-companies-into-smart-verticals"},{"title":"Reclassify all classified companies","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/smart-verticals/reclassify","href":"/api-reference/smart-verticals/reclassify-all-classified-companies"},{"title":"Update a smart vertical","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml put /v2/smart-verticals/{smartVerticalID}","href":"/api-reference/smart-verticals/update-a-smart-vertical"},{"title":"Delete a smart vertical","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/smart-verticals/{smartVerticalID}","href":"/api-reference/smart-verticals/delete-a-smart-vertical"}]},{"group":"Webhooks","pages":[{"title":"List webhook deliveries","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/webhook-deliveries","href":"/api-reference/webhooks/list-webhook-deliveries"},{"title":"Replay a webhook delivery","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/webhook-deliveries/{deliveryID}/replay","href":"/api-reference/webhooks/replay-a-webhook-delivery"},{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/webhook-endpoints","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/webhook-endpoints","href":"/api-reference/webhooks/create-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/webhook-endpoints/{endpointID}","href":"/api-reference/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml patch /v2/webhook-endpoints/{endpointID}","href":"/api-reference/webhooks/update-a-webhook-endpoint"}]}]}]},"title":"List personas - TAMTAM","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}