[{"data":1,"prerenderedAt":1089},["ShallowReactive",2],{"docs-navigation":3,"docs-\u002Fendpoints\u002Flist-create":459},[4,12,16,21,27,34,41,47,54,59,65,71,76,81,86,91,96,101,106,111,116,121,127,132,137,142,148,154,159,164,169,174,179,186,192,197,202,208,213,218,223,227,232,237,240,244,249,253,256,260,263,267,270,273,279,282,286,289,292,295,299,303,306,310,313,316,319,322,326,330,334,338,343,347,350,353,356,359,362,365,368,371,374,377,380,383,386,389,393,396,399,401,403,405,407,409,411,413,415,417,419,421,423,425,427,429,431,433,435,440,443,447,450,453,456],{"path":5,"title":6,"category":7,"order":8,"family":9,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fagents","Agent brief","mcp",40,"AI agents",null,"new",{"path":13,"title":14,"category":7,"order":15,"family":9,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fai-agents","Use Reverse Contact from an AI agent",10,{"path":17,"title":18,"category":19,"order":20,"family":10,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fapi-reference","API reference","introduction",30,{"path":22,"title":23,"category":19,"order":24,"family":25,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fauthentication","Authentication",20,"Get started","updated",{"path":28,"title":29,"category":30,"order":31,"family":32,"subfamily":10,"status":11,"endpointId":33,"badgeLabel":10},"\u002Fendpoints\u002Fbulk-enrich-persons","Bulk enrichment","endpoints",660,"Bulk","bulk-enrich-persons",{"path":35,"title":36,"category":30,"order":37,"family":38,"subfamily":39,"status":26,"endpointId":40,"badgeLabel":10},"\u002Fendpoints\u002Fcheck-company","Company profile status",220,"Fetch","Company","check-company",{"path":42,"title":43,"category":30,"order":44,"family":38,"subfamily":45,"status":26,"endpointId":46,"badgeLabel":10},"\u002Fendpoints\u002Fcheck-person","Person profile status",120,"Person","check-person",{"path":48,"title":49,"category":30,"order":50,"family":51,"subfamily":52,"status":10,"endpointId":53,"badgeLabel":10},"\u002Fendpoints\u002Fcontact-email","Find Email",600,"Contact","Email","contact-email",{"path":55,"title":56,"category":30,"order":57,"family":51,"subfamily":52,"status":10,"endpointId":58,"badgeLabel":10},"\u002Fendpoints\u002Fcontact-email-verify","Verify Email",605,"contact-email-verify",{"path":60,"title":61,"category":30,"order":62,"family":51,"subfamily":63,"status":10,"endpointId":64,"badgeLabel":10},"\u002Fendpoints\u002Fcontact-phone","Find Phone",610,"Phone","contact-phone",{"path":66,"title":67,"category":30,"order":68,"family":69,"subfamily":39,"status":26,"endpointId":70,"badgeLabel":10},"\u002Fendpoints\u002Fenrich-company","Enrich company",90,"Enrichment","enrich-company",{"path":72,"title":73,"category":30,"order":74,"family":69,"subfamily":45,"status":26,"endpointId":75,"badgeLabel":10},"\u002Fendpoints\u002Fenrich-person","Enrich profile",80,"enrich-person",{"path":77,"title":78,"category":30,"order":79,"family":38,"subfamily":39,"status":26,"endpointId":80,"badgeLabel":10},"\u002Fendpoints\u002Ffetch-company","Company profile",200,"fetch-company",{"path":82,"title":83,"category":30,"order":84,"family":38,"subfamily":39,"status":26,"endpointId":85,"badgeLabel":10},"\u002Fendpoints\u002Ffetch-company-live","Company profile live",210,"fetch-company-live",{"path":87,"title":88,"category":30,"order":89,"family":38,"subfamily":45,"status":26,"endpointId":90,"badgeLabel":10},"\u002Fendpoints\u002Ffetch-profile","Person profile",100,"fetch-profile",{"path":92,"title":93,"category":30,"order":94,"family":38,"subfamily":45,"status":26,"endpointId":95,"badgeLabel":10},"\u002Fendpoints\u002Ffetch-profile-live","Person profile live",110,"fetch-profile-live",{"path":97,"title":98,"category":30,"order":99,"family":32,"subfamily":10,"status":11,"endpointId":100,"badgeLabel":10},"\u002Fendpoints\u002Fjob","Get a job",662,"job",{"path":102,"title":103,"category":30,"order":104,"family":32,"subfamily":10,"status":11,"endpointId":105,"badgeLabel":10},"\u002Fendpoints\u002Fjob-cancel","Cancel a job",664,"job-cancel",{"path":107,"title":108,"category":30,"order":109,"family":32,"subfamily":10,"status":11,"endpointId":110,"badgeLabel":10},"\u002Fendpoints\u002Fjob-results","Download job results",663,"job-results",{"path":112,"title":113,"category":30,"order":114,"family":32,"subfamily":10,"status":11,"endpointId":115,"badgeLabel":10},"\u002Fendpoints\u002Fjob-rows","Read job results by page",663.5,"job-rows",{"path":117,"title":118,"category":30,"order":119,"family":32,"subfamily":10,"status":11,"endpointId":120,"badgeLabel":10},"\u002Fendpoints\u002Fjobs","Job history",661,"jobs",{"path":122,"title":123,"category":30,"order":124,"family":125,"subfamily":125,"status":11,"endpointId":126,"badgeLabel":10},"\u002Fendpoints\u002Flist","Get a List",642,"Lists","list",{"path":128,"title":129,"category":30,"order":130,"family":125,"subfamily":125,"status":11,"endpointId":131,"badgeLabel":10},"\u002Fendpoints\u002Flist-create","Create a List",641,"list-create",{"path":133,"title":134,"category":30,"order":135,"family":125,"subfamily":125,"status":11,"endpointId":136,"badgeLabel":10},"\u002Fendpoints\u002Flist-delete","Delete a List",643,"list-delete",{"path":138,"title":139,"category":30,"order":140,"family":125,"subfamily":125,"status":11,"endpointId":141,"badgeLabel":10},"\u002Fendpoints\u002Flist-export","Export a List",644,"list-export",{"path":143,"title":144,"category":30,"order":145,"family":125,"subfamily":146,"status":11,"endpointId":147,"badgeLabel":10},"\u002Fendpoints\u002Flist-intake-signals","Import members and data",648,"Imports","list-intake-signals",{"path":149,"title":150,"category":30,"order":151,"family":125,"subfamily":152,"status":11,"endpointId":153,"badgeLabel":10},"\u002Fendpoints\u002Flist-members","List members",645,"Members","list-members",{"path":155,"title":156,"category":30,"order":157,"family":125,"subfamily":152,"status":11,"endpointId":158,"badgeLabel":10},"\u002Fendpoints\u002Flist-members-add","Add members",646,"list-members-add",{"path":160,"title":161,"category":30,"order":162,"family":125,"subfamily":152,"status":11,"endpointId":163,"badgeLabel":10},"\u002Fendpoints\u002Flist-members-remove","Remove members",647,"list-members-remove",{"path":165,"title":166,"category":30,"order":167,"family":125,"subfamily":146,"status":11,"endpointId":168,"badgeLabel":10},"\u002Fendpoints\u002Flist-operation","Read a List operation",649,"list-operation",{"path":170,"title":171,"category":30,"order":172,"family":125,"subfamily":146,"status":11,"endpointId":173,"badgeLabel":10},"\u002Fendpoints\u002Flist-operation-cancel","Cancel a List operation",650,"list-operation-cancel",{"path":175,"title":176,"category":30,"order":177,"family":125,"subfamily":125,"status":11,"endpointId":178,"badgeLabel":10},"\u002Fendpoints\u002Flists","All Lists",640,"lists",{"path":180,"title":181,"category":30,"order":182,"family":183,"subfamily":184,"status":11,"endpointId":185,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-companies","Company search",94,"Search","Companies","search-organizations",{"path":187,"title":188,"category":30,"order":189,"family":190,"subfamily":10,"status":11,"endpointId":191,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-companies-available-fields","Company search available fields",720,"Utility","search-organizations-available-fields",{"path":193,"title":194,"category":30,"order":195,"family":183,"subfamily":184,"status":11,"endpointId":196,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-companies-count","Company search count",95,"search-organizations-count",{"path":198,"title":199,"category":30,"order":200,"family":183,"subfamily":184,"status":11,"endpointId":201,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-companies-prompt","Agentic Company Search",97,"search-organizations-prompt",{"path":203,"title":204,"category":30,"order":205,"family":183,"subfamily":206,"status":11,"endpointId":207,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people","People search",92,"People","search-people",{"path":209,"title":210,"category":30,"order":211,"family":190,"subfamily":10,"status":11,"endpointId":212,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-auto-suggestion","People auto-suggestion",730,"search-people-auto-suggestion",{"path":214,"title":215,"category":30,"order":216,"family":190,"subfamily":10,"status":11,"endpointId":217,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-available-fields","People search available fields",710,"search-people-available-fields",{"path":219,"title":220,"category":30,"order":221,"family":183,"subfamily":206,"status":11,"endpointId":222,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-count","People search count",93,"search-people-count",{"path":224,"title":225,"category":30,"order":195,"family":183,"subfamily":206,"status":11,"endpointId":226,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-lookalike","People lookalike","search-people-lookalike",{"path":228,"title":229,"category":30,"order":230,"family":183,"subfamily":206,"status":11,"endpointId":231,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-prompt","Agentic Search",96,"search-people-prompt",{"path":233,"title":234,"category":30,"order":235,"family":190,"subfamily":10,"status":26,"endpointId":236,"badgeLabel":10},"\u002Fendpoints\u002Fusage","Usage",700,"usage",{"path":238,"title":239,"category":19,"order":15,"family":25,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fgetting-started","Getting started",{"path":241,"title":242,"category":243,"order":20,"family":9,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fagent-skills","Agent skills","cli",{"path":245,"title":246,"category":247,"order":20,"family":248,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fapi-key-management","API key management","guides","Credits & limits",{"path":250,"title":251,"category":247,"order":24,"family":252,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fbuild-a-list","Build your first List","Work in bulk",{"path":254,"title":255,"category":247,"order":20,"family":252,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fbulk-enrichment","Enrich people in bulk",{"path":257,"title":258,"category":243,"order":15,"family":259,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fcli","Command line interface (CLI)","CLI",{"path":261,"title":262,"category":247,"order":15,"family":248,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fcredits","Credits",{"path":264,"title":265,"category":247,"order":8,"family":266,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fcurrent-position-resolution","Current position and work history ordering","Understand the data",{"path":268,"title":269,"category":247,"order":24,"family":266,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fdata-freshness","Data freshness",{"path":271,"title":272,"category":247,"order":15,"family":266,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fdata-quality","Data quality",{"path":274,"title":275,"category":276,"order":277,"family":10,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":278},"\u002Fguides\u002Fendpoint-transition-october-2026","Endpoint transition on October 13, 2026","migrations",1,"Important",{"path":280,"title":281,"category":247,"order":8,"family":252,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fenrich-a-csv-file","Enrich a CSV file",{"path":283,"title":284,"category":247,"order":15,"family":285,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Ferrors-retries","Error handling & retries","Go to production",{"path":287,"title":288,"category":247,"order":20,"family":25,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Ffirst-api-call","Your first API call",{"path":290,"title":291,"category":247,"order":15,"family":252,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Flists","Lists: orchestrate enrichment",{"path":293,"title":294,"category":7,"order":24,"family":9,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fmcp","Connect AI agents (MCP)",{"path":296,"title":297,"category":276,"order":298,"family":10,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fmigrating-search-companies-to-organizations","Migrating company search to the new endpoint",2,{"path":300,"title":301,"category":276,"order":302,"family":10,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fmigrating-search-persons-to-people","Migrating people search from persons to people",51,{"path":304,"title":305,"category":247,"order":20,"family":266,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fmissing-and-empty-fields","Missing and empty profile fields",{"path":307,"title":308,"category":247,"order":15,"family":309,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fpolling","Polling for async results","Async results",{"path":311,"title":312,"category":247,"order":24,"family":285,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fproduction-checklist","Production checklist",{"path":314,"title":315,"category":247,"order":24,"family":248,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Frate-limits","Rate limits",{"path":317,"title":318,"category":247,"order":24,"family":309,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fwebhooks","Webhooks",{"path":320,"title":321,"category":247,"order":8,"family":25,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fwhich-endpoint-should-i-use","Which endpoint should I use?",{"path":323,"title":324,"category":325,"order":302,"family":10,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Freference\u002Fareas","Area values","reference",{"path":327,"title":328,"category":325,"order":329,"family":10,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Freference\u002Findustries","Industry values",50,{"path":331,"title":332,"category":333,"order":15,"family":25,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript","TypeScript and JavaScript SDK","sdk",{"path":335,"title":336,"category":333,"order":15,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fasync-jobs","Async jobs","Guides",{"path":339,"title":340,"category":333,"order":341,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fbulk","client.bulk",60,"Resources",{"path":344,"title":345,"category":333,"order":346,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fclient-options","Client options",70,{"path":348,"title":349,"category":333,"order":8,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fcontact","client.contact",{"path":351,"title":352,"category":333,"order":15,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fenrich","client.enrich",{"path":354,"title":355,"category":333,"order":329,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Ferrors-and-retries","Errors and retries",{"path":357,"title":358,"category":333,"order":24,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Ffetch","client.fetch",{"path":360,"title":361,"category":333,"order":8,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Ffilter-constants","Filter values as constants",{"path":363,"title":364,"category":333,"order":20,"family":25,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Ffirst-call","First call",{"path":366,"title":367,"category":333,"order":24,"family":25,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Finstall","Install and configure",{"path":369,"title":370,"category":333,"order":346,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fjobs","client.jobs",{"path":372,"title":373,"category":333,"order":329,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Flists","client.lists",{"path":375,"title":376,"category":333,"order":24,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Flists-and-bulk","Lists and Bulk enrichment",{"path":378,"title":379,"category":333,"order":20,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fsearch","client.search",{"path":381,"title":382,"category":333,"order":20,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fsearch-budget","Search within a budget",{"path":384,"title":385,"category":333,"order":341,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Ftimeouts","Timeouts and cancellation",{"path":387,"title":388,"category":333,"order":74,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fusage","client.usage",{"path":390,"title":391,"category":333,"order":15,"family":392,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fwithout-the-sdk","Without the SDK","More",{"path":394,"title":395,"category":333,"order":15,"family":25,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython","Python SDK",{"path":397,"title":398,"category":333,"order":15,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fasync-client","Async client",{"path":400,"title":336,"category":333,"order":24,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fasync-jobs",{"path":402,"title":340,"category":333,"order":341,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fbulk",{"path":404,"title":345,"category":333,"order":74,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fclient-options",{"path":406,"title":349,"category":333,"order":8,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fcontact",{"path":408,"title":352,"category":333,"order":15,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fenrich",{"path":410,"title":355,"category":333,"order":341,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Ferrors-and-retries",{"path":412,"title":358,"category":333,"order":24,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Ffetch",{"path":414,"title":361,"category":333,"order":329,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Ffilter-constants",{"path":416,"title":364,"category":333,"order":20,"family":25,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Ffirst-call",{"path":418,"title":367,"category":333,"order":24,"family":25,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Finstall",{"path":420,"title":370,"category":333,"order":346,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fjobs",{"path":422,"title":373,"category":333,"order":329,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Flists",{"path":424,"title":376,"category":333,"order":20,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Flists-and-bulk",{"path":426,"title":379,"category":333,"order":20,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fsearch",{"path":428,"title":382,"category":333,"order":8,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fsearch-budget",{"path":430,"title":385,"category":333,"order":346,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Ftimeouts",{"path":432,"title":388,"category":333,"order":74,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fusage",{"path":434,"title":391,"category":333,"order":15,"family":392,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fwithout-the-sdk",{"path":436,"title":437,"category":438,"order":341,"family":439,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases\u002Fbuild-a-list-of-companies","Build a list of companies","use-cases","Build lists",{"path":441,"title":442,"category":438,"order":329,"family":439,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases\u002Fbuild-a-list-of-people","Build a list of people",{"path":444,"title":445,"category":438,"order":24,"family":446,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases\u002Ffind-a-company","Find a company from a domain or a page URL","Find & enrich",{"path":448,"title":449,"category":438,"order":15,"family":446,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases\u002Ffind-a-person","Find a person from an email, a name or a profile URL",{"path":451,"title":452,"category":438,"order":8,"family":51,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases\u002Fget-a-work-email-or-phone","Get a work email or a phone number",{"path":454,"title":455,"category":438,"order":277,"family":10,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases","Reverse Contact API use cases",{"path":457,"title":458,"category":438,"order":20,"family":446,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases\u002Fkeep-profiles-fresh","Keep profiles fresh",{"id":460,"title":129,"audience":10,"badgeColor":10,"badgeLabel":10,"body":461,"category":30,"description":1080,"endpointId":131,"extension":1081,"family":125,"lastVerified":1082,"links":10,"meta":1083,"navigation":1084,"order":130,"path":128,"relatedArticles":1085,"requiresFlag":10,"seo":1086,"status":11,"stem":1087,"subfamily":125,"__hash__":1088},"docs\u002Fendpoints\u002Flist-create.md",{"type":462,"value":463,"toc":1068},"minimark",[464,468,484,499,513,522,526,572,576,626,631,650,654,659,708,887,900,904,1008,1012,1045,1049],[465,466,467],"h2",{"id":19},"Introduction",[469,470,471,472,476,477,480,481,483],"p",{},"The Create a List endpoint creates an empty List of people or of companies. A List never mixes both: its ",[473,474,475],"code",{},"entity"," decides which Signals it accepts and which data families it can hold. Fill it afterwards with ",[478,479,156],"a",{"href":155}," or ",[478,482,144],{"href":143},".",[469,485,486,487,491,492,495,496,483],{},"Creating a List is ",[488,489,490],"strong",{},"free"," (0 credits). A workspace holds at most 200 Lists, and 1 on the free trial: past that, the request returns ",[473,493,494],{},"409 LIST_LIMIT_REACHED",". When the name is already taken, the List is created as ",[473,497,498],{},"Name (2)",[469,500,501,502,505,506,509,510,483],{},"The first List of a workspace also sets up where its Lists are stored. While that runs, the request returns ",[473,503,504],{},"503 LISTS_PREPARING",", with ",[473,507,508],{},"error.details.retryAfterSeconds",": send the same request again a few seconds later, with the same ",[473,511,512],{},"Idempotency-Key",[469,514,515,516,518,519,521],{},"The API key needs the ",[473,517,178],{}," permission (see ",[478,520,246],{"href":245},").",[465,523,525],{"id":524},"authorization","Authorization",[527,528,529,548],"table",{},[530,531,532],"thead",{},[533,534,535,539,542,545],"tr",{},[536,537,538],"th",{},"Name",[536,540,541],{},"Type",[536,543,544],{},"Required",[536,546,547],{},"Description",[549,550,551],"tbody",{},[533,552,553,559,562,565],{},[554,555,556],"td",{},[473,557,558],{},"apikey",[554,560,561],{},"string",[554,563,564],{},"Yes",[554,566,567,568,571],{},"Your API key from the developer dashboard. Pass it via ",[473,569,570],{},"Authorization: Bearer YOUR_API_KEY"," header.",[465,573,575],{"id":574},"request-body","Request body",[527,577,578,590],{},[530,579,580],{},[533,581,582,584,586,588],{},[536,583,538],{},[536,585,541],{},[536,587,544],{},[536,589,547],{},[549,591,592,606],{},[533,593,594,599,601,603],{},[554,595,596],{},[473,597,598],{},"name",[554,600,561],{},[554,602,564],{},[554,604,605],{},"List name, 1 to 200 characters. Spaces around it are removed.",[533,607,608,612,614,616],{},[554,609,610],{},[473,611,475],{},[554,613,561],{},[554,615,564],{},[554,617,618,621,622,625],{},[473,619,620],{},"persons"," for people, ",[473,623,624],{},"companies"," for companies",[627,628,630],"h3",{"id":629},"retry-safely-with-idempotency-key","Retry safely with Idempotency-Key",[469,632,633,634,636,637,640,641,643,644,646,647,483],{},"Send an ",[473,635,512],{}," header (1 to 200 printable ASCII characters, no spaces) to make the creation safe to retry: a second request with the same key returns the List the first one created, with ",[473,638,639],{},"201",", instead of creating ",[473,642,498],{},". Reusing the key for the other ",[473,645,475],{}," returns ",[473,648,649],{},"409 IDEMPOTENCY_KEY_REUSED",[465,651,653],{"id":652},"response-structure","Response structure",[469,655,656,657,483],{},"The response has status ",[473,658,639],{},[527,660,661,672],{},[530,662,663],{},[533,664,665,668,670],{},[536,666,667],{},"Field",[536,669,541],{},[536,671,547],{},[549,673,674,690],{},[533,675,676,681,684],{},[554,677,678],{},[473,679,680],{},"success",[554,682,683],{},"boolean",[554,685,686,689],{},[473,687,688],{},"true"," if the List was created",[533,691,692,697,702],{},[554,693,694],{},[473,695,696],{},"error",[554,698,699],{},[473,700,701],{},"null",[554,703,704,705,707],{},"Always ",[473,706,701],{}," on success",[709,710,713,719],"docs-object",{"field":711,"type":712},"data","List",[714,715,716],"docs-object-description",{},[469,717,718],{},"The List created, or the List this Idempotency-Key created",[720,721,722],"docs-object-children",{},[527,723,724,734],{},[530,725,726],{},[533,727,728,730,732],{},[536,729,667],{},[536,731,541],{},[536,733,547],{},[549,735,736,748,759,773,790,804,816,832,844,856,872],{},[533,737,738,743,745],{},[554,739,740],{},[473,741,742],{},"id",[554,744,561],{},[554,746,747],{},"List id (UUID): keep it to fill and read the List",[533,749,750,754,756],{},[554,751,752],{},[473,753,598],{},[554,755,561],{},[554,757,758],{},"List name, suffixed when the name was already taken",[533,760,761,765,767],{},[554,762,763],{},[473,764,475],{},[554,766,561],{},[554,768,769,480,771],{},[473,770,620],{},[473,772,624],{},[533,774,775,780,783],{},[554,776,777],{},[473,778,779],{},"memberCount",[554,781,782],{},"number",[554,784,785,786,789],{},"List Members, ",[473,787,788],{},"0"," for a new List",[533,791,792,797,799],{},[554,793,794],{},[473,795,796],{},"pendingIntakeCount",[554,798,782],{},[554,800,801,802,789],{},"Pending Intake lines, ",[473,803,788],{},[533,805,806,811,813],{},[554,807,808],{},[473,809,810],{},"revision",[554,812,782],{},[554,814,815],{},"Raised by every change to the members",[533,817,818,823,827],{},[554,819,820],{},[473,821,822],{},"archivedAt",[554,824,825],{},[473,826,701],{},[554,828,829,831],{},[473,830,701],{}," for an active List",[533,833,834,839,841],{},[554,835,836],{},[473,837,838],{},"createdAt",[554,840,561],{},[554,842,843],{},"Creation date (ISO 8601)",[533,845,846,851,853],{},[554,847,848],{},[473,849,850],{},"updatedAt",[554,852,561],{},[554,854,855],{},"Last update date (ISO 8601)",[533,857,858,863,867],{},[554,859,860],{},[473,861,862],{},"originQuery",[554,864,865],{},[473,866,701],{},[554,868,869,871],{},[473,870,701],{}," for a List created through the API",[533,873,874,879,883],{},[554,875,876],{},[473,877,878],{},"originLastFind",[554,880,881],{},[473,882,701],{},[554,884,885,871],{},[473,886,701],{},[469,888,889,892,893,896,897,483],{},[473,890,891],{},"quotas"," and ",[473,894,895],{},"metadata"," are the blocks of every V2 response: see ",[478,898,234],{"href":899},"\u002Fendpoints\u002Fusage#response-structure",[465,901,903],{"id":902},"errors","Errors",[527,905,906,919],{},[530,907,908],{},[533,909,910,913,916],{},[536,911,912],{},"Status",[536,914,915],{},"Code",[536,917,918],{},"Meaning",[549,920,921,942,957,973,993],{},[533,922,923,928,933],{},[554,924,925],{},[473,926,927],{},"400",[554,929,930],{},[473,931,932],{},"LIST_INVALID_INPUT",[554,934,935,936,938,939,941],{},"The ",[473,937,512],{}," header is malformed, or ",[473,940,598],{}," holds only spaces",[533,943,944,949,954],{},[554,945,946],{},[473,947,948],{},"409",[554,950,951],{},[473,952,953],{},"LIST_LIMIT_REACHED",[554,955,956],{},"The workspace already has 200 Lists (1 on the free trial)",[533,958,959,963,968],{},[554,960,961],{},[473,962,948],{},[554,964,965],{},[473,966,967],{},"IDEMPOTENCY_KEY_REUSED",[554,969,970,971],{},"The key already created a List of the other ",[473,972,475],{},[533,974,975,980,985],{},[554,976,977],{},[473,978,979],{},"422",[554,981,982],{},[473,983,984],{},"VALIDATION_ERROR",[554,986,987,989,990,992],{},[473,988,598],{}," is missing or too long, or ",[473,991,475],{}," is not a known value",[533,994,995,1000,1005],{},[554,996,997],{},[473,998,999],{},"503",[554,1001,1002],{},[473,1003,1004],{},"LISTS_PREPARING",[554,1006,1007],{},"The first List of the workspace is being set up: retry in a few seconds",[465,1009,1011],{"id":1010},"code-examples","Code examples",[1013,1014,1016,1027,1036],"code-group",{"title":1015},"Code Examples",[1017,1018,1025],"pre",{"className":1019,"code":1021,"filename":1022,"language":1023,"meta":1024},[1020],"language-bash","curl -X POST https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Flists \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"Idempotency-Key: crm-sync-2026-10-28\" \\\n  -d '{ \"name\": \"Q4 sales leaders\", \"entity\": \"persons\" }'\n","cURL","bash","",[473,1026,1021],{"__ignoreMap":1024},[1017,1028,1034],{"className":1029,"code":1031,"filename":1032,"language":1033,"meta":1024},[1030],"language-javascript","const response = await fetch(\"https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Flists\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": \"Bearer YOUR_API_KEY\",\n    \"Content-Type\": \"application\u002Fjson\",\n    \"Idempotency-Key\": \"crm-sync-2026-10-28\"\n  },\n  body: JSON.stringify({ name: \"Q4 sales leaders\", entity: \"persons\" })\n});\n\nconst { data: list } = await response.json();\nconsole.log(\"List created:\", list.id);\n","JavaScript","javascript",[473,1035,1031],{"__ignoreMap":1024},[1017,1037,1043],{"className":1038,"code":1040,"filename":1041,"language":1042,"meta":1024},[1039],"language-python","import requests\n\nresponse = requests.post(\n    \"https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Flists\",\n    headers={\n        \"Authorization\": \"Bearer YOUR_API_KEY\",\n        \"Content-Type\": \"application\u002Fjson\",\n        \"Idempotency-Key\": \"crm-sync-2026-10-28\"\n    },\n    json={\"name\": \"Q4 sales leaders\", \"entity\": \"persons\"}\n)\n\nprint(\"List created:\", response.json()[\"data\"][\"id\"])\n","Python","python",[473,1044,1040],{"__ignoreMap":1024},[465,1046,1048],{"id":1047},"example-response","Example response",[1013,1050,1052,1061],{"title":1051},"Example Response",[1017,1053,1059],{"className":1054,"code":1056,"filename":1057,"language":1058,"meta":1024},[1055],"language-json","{\n  \"success\": true,\n  \"data\": {\n    \"id\": \"3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\",\n    \"name\": \"Q4 sales leaders\",\n    \"entity\": \"persons\",\n    \"memberCount\": 0,\n    \"pendingIntakeCount\": 0,\n    \"revision\": 1,\n    \"archivedAt\": null,\n    \"createdAt\": \"2026-10-28T09:12:44.000Z\",\n    \"updatedAt\": \"2026-10-28T09:12:44.000Z\",\n    \"originQuery\": null,\n    \"originLastFind\": null\n  },\n  \"error\": null,\n  \"quotas\": {\n    \"creditsConsumed\": 0,\n    \"workspace\": {\n      \"id\": \"ws_abc123\",\n      \"credits\": { \"total\": 10000, \"used\": 4521, \"left\": 5479 }\n    }\n  },\n  \"metadata\": {\n    \"requestId\": \"b4777f52-42fd-44e7-abc5-19955b65c753\",\n    \"executionTimeMs\": 52\n  }\n}\n","201 - Created","json",[473,1060,1056],{"__ignoreMap":1024},[1017,1062,1066],{"className":1063,"code":1064,"filename":1065,"language":1058,"meta":1024},[1055],"{\n  \"success\": false,\n  \"data\": null,\n  \"error\": {\n    \"code\": \"LIST_LIMIT_REACHED\",\n    \"message\": \"This workspace already has 200 lists\"\n  },\n  \"quotas\": {\n    \"creditsConsumed\": 0,\n    \"workspace\": {\n      \"id\": \"ws_abc123\",\n      \"credits\": { \"total\": 10000, \"used\": 4521, \"left\": 5479 }\n    }\n  },\n  \"metadata\": {\n    \"requestId\": \"3f594ff6-5425-4f46-b2b9-8c65acebd9f0\",\n    \"executionTimeMs\": 21\n  }\n}\n","409 - Limit reached",[473,1067,1064],{"__ignoreMap":1024},{"title":1024,"searchDepth":1069,"depth":1069,"links":1070},3,[1071,1072,1073,1076,1077,1078,1079],{"id":19,"depth":298,"text":467},{"id":524,"depth":298,"text":525},{"id":574,"depth":298,"text":575,"children":1074},[1075],{"id":629,"depth":1069,"text":630},{"id":652,"depth":298,"text":653},{"id":902,"depth":298,"text":903},{"id":1010,"depth":298,"text":1011},{"id":1047,"depth":298,"text":1048},"Create an empty List of people or companies in your workspace for free, and use an Idempotency-Key header to retry without creating duplicates.","md","2026-11-04",{},true,"\u002Fdocs\u002Fguides\u002Flists,\u002Fdocs\u002Fguides\u002Fbuild-a-list,\u002Fdocs\u002Fendpoints\u002Flist-members-add,\u002Fdocs\u002Fendpoints\u002Flist-intake-signals",{"title":129,"description":1080},"endpoints\u002Flist-create","KeXxA2esiTjFaXtOzUDBjyeG0rKZqbHPHsXPnhZR0so",1793830201837]