[{"data":1,"prerenderedAt":1757},["ShallowReactive",2],{"docs-navigation":3,"docs-\u002Fendpoints\u002Flist-intake-signals":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":144,"audience":10,"badgeColor":10,"badgeLabel":10,"body":461,"category":30,"description":1748,"endpointId":147,"extension":1749,"family":125,"lastVerified":1750,"links":10,"meta":1751,"navigation":1752,"order":145,"path":143,"relatedArticles":1753,"requiresFlag":10,"seo":1754,"status":11,"stem":1755,"subfamily":146,"__hash__":1756},"docs\u002Fendpoints\u002Flist-intake-signals.md",{"type":462,"value":463,"toc":1731},"minimark",[464,468,490,502,505,516,604,612,629,650,656,660,700,704,719,894,899,921,925,941,960,964,967,1015,1033,1037,1067,1071,1092,1139,1271,1296,1311,1314,1326,1339,1462,1490,1497,1501,1671,1675,1708,1712],[465,466,467],"h2",{"id":19},"Introduction",[469,470,471,472,476,477,480,481,485,486,489],"p",{},"The Import members and data endpoint queues up to 25,000 Signals, or a public CSV file or Google Sheet, as one operation on a List. It answers at once with an ",[473,474,475],"code",{},"operationId"," and a ",[473,478,479],{},"pollUrl",", then works in the background: each line is identified like an ",[482,483,484],"a",{"href":155},"add",", and with ",[473,487,488],{},"families",", the data you ask for is bought for each member, new or already on the List.",[469,491,492,493,495,496,498,499,501],{},"Use it instead of ",[482,494,156],{"href":155}," for more than 1,000 Signals, to fill a List with emails, phone numbers, profiles or company details, to set a credit ceiling, or to be told by webhook when the import stops moving. Follow it with ",[482,497,166],{"href":165}," and stop it with ",[482,500,171],{"href":170},".",[465,503,262],{"id":504},"credits",[469,506,507,508,512,513,501],{},"Queuing the import is ",[509,510,511],"strong",{},"free",": the operation is charged line by line as it runs, and never more than ",[473,514,515],{},"maxCredits",[517,518,519,531],"table",{},[520,521,522],"thead",{},[523,524,525,529],"tr",{},[526,527,528],"th",{},"What the line does",[526,530,262],{},[532,533,534,547,555,563,574,584,594],"tbody",{},[523,535,536,540],{},[537,538,539],"td",{},"Adds a new person",[537,541,542,543,546],{},"1 from a Social profile URL (2 with ",[473,544,545],{},"live: true","), 2 from an email or a name",[523,548,549,552],{},[537,550,551],{},"Adds a new company",[537,553,554],{},"1 from a company page URL or id (2 when the page is read live), 2 from a domain",[523,556,557,560],{},[537,558,559],{},"Names a member already on the List, or no one",[537,561,562],{},"Free",[523,564,565,571],{},[537,566,567,570],{},[473,568,569],{},"profile"," family",[537,572,573],{},"Per member that lacks it, 1 when read from its Social profile URL, 2 when found by name (2 in the worst case). A person the import adds comes with their profile, free.",[523,575,576,581],{},[537,577,578,570],{},[473,579,580],{},"company",[537,582,583],{},"Per member, 1 from a company page URL, 2 from a domain (2 in the worst case). On a people List, it is the person's current company. On a companies List, a company the import adds comes with its details, free.",[523,585,586,591],{},[537,587,588,570],{},[473,589,590],{},"contact_email",[537,592,593],{},"3 per email found, free when none is found. The email of an email Signal is kept as the member's email, free.",[523,595,596,601],{},[537,597,598,570],{},[473,599,600],{},"contact_phone",[537,602,603],{},"20 per phone number found, free when none is found",[469,605,606,607,611],{},"Data a member already holds is never bought again, and an email or a phone number already looked for, found or not, is not looked for again: an import replayed on the same List charges only what is missing. A line no one matches is kept as ",[482,608,610],{"href":609},"\u002Fguides\u002Flists#pending-intake","Pending Intake",", free. When a Signal sent again finds someone, the new member replaces its Pending Intake line.",[469,613,614,615,617,618,620,621,624,625,628],{},"The ",[473,616,600],{}," family needs phone finding on your workspace, as ",[482,619,61],{"href":60}," does. Without it, the member of each line that asks for a phone number is still added, the line reads ",[473,622,623],{},"resolved"," with ",[473,626,627],{},"errorCode: \"CONTACT_PHONE_FINDER_DISABLED\"",", and no phone number is charged.",[469,630,631,632,634,635,638,639,642,643,646,647,649],{},"The API key needs the ",[473,633,178],{}," permission, plus the permission of each thing the import buys: ",[473,636,637],{},"persons:enrich"," for people and their profiles, ",[473,640,641],{},"companies:enrich"," for companies and company details, ",[473,644,645],{},"contact"," for the email and phone families (see ",[482,648,246],{"href":245},").",[469,651,652,653,501],{},"The request that starts an import counts as one request on your daily limit and is not counted against your per-minute limit, whatever its number of lines. Its lines then take their share of your per-minute limit as they run, at most 80% of it, and wait when that share is taken. Reading the operation is never counted. See ",[482,654,315],{"href":655},"\u002Fguides\u002Frate-limits#how-requests-are-counted",[465,657,659],{"id":658},"authorization","Authorization",[517,661,662,678],{},[520,663,664],{},[523,665,666,669,672,675],{},[526,667,668],{},"Name",[526,670,671],{},"Type",[526,673,674],{},"Required",[526,676,677],{},"Description",[532,679,680],{},[523,681,682,687,690,693],{},[537,683,684],{},[473,685,686],{},"apikey",[537,688,689],{},"string",[537,691,692],{},"Yes",[537,694,695,696,699],{},"Your API key from the developer dashboard. Pass it via ",[473,697,698],{},"Authorization: Bearer YOUR_API_KEY"," header.",[465,701,703],{"id":702},"request-body","Request body",[469,705,706,707,710,711,714,715,718],{},"The List is named in the path: ",[473,708,709],{},"POST \u002Fv2\u002Flists\u002F:listId\u002Fintake\u002Fsignals",". Send ",[473,712,713],{},"signals"," or ",[473,716,717],{},"sourceUrl",", not both.",[517,720,721,733],{},[520,722,723],{},[523,724,725,727,729,731],{},[526,726,668],{},[526,728,671],{},[526,730,674],{},[526,732,677],{},[532,734,735,758,774,803,820,842,855,873],{},[523,736,737,741,744,747],{},[537,738,739],{},[473,740,713],{},[537,742,743],{},"array",[537,745,746],{},"Conditional",[537,748,749,750,753,754,757],{},"1 to 25,000 Signals, with the fields of ",[482,751,156],{"href":752},"\u002Fendpoints\u002Flist-members-add#request-body",", ",[473,755,756],{},"externalId"," included",[523,759,760,764,766,768],{},[537,761,762],{},[473,763,717],{},[537,765,689],{},[537,767,746],{},[537,769,770,771,773],{},"A public HTTPS CSV file or Google Sheet URL instead of ",[473,772,713],{},": up to 25,000 rows and 25 MiB. Columns are matched from their headers (Social URL, email, first name, last name, company, domain).",[523,775,776,780,785,788],{},[537,777,778],{},[473,779,488],{},[537,781,689,782],{},[783,784],"span",{},[537,786,787],{},"No",[537,789,790,791,753,793,753,795,753,797,799,800,802],{},"Data to buy for each member: ",[473,792,569],{},[473,794,580],{},[473,796,590],{},[473,798,600],{},". A companies List takes ",[473,801,580],{}," only.",[523,804,805,809,812,814],{},[537,806,807],{},[473,808,515],{},[537,810,811],{},"integer",[537,813,746],{},[537,815,816,817,819],{},"The most this operation may spend. Required with ",[473,818,488],{}," when the worst case is above 25 credits. Omitted, the ceiling is the worst case of the import.",[523,821,822,827,830,832],{},[537,823,824],{},[473,825,826],{},"live",[537,828,829],{},"boolean",[537,831,787],{},[537,833,834,837,838,841],{},[473,835,836],{},"true"," fetches the profile of each Social profile URL live. Omitted or ",[473,839,840],{},"false",", saved data is used. No effect on a companies List.",[523,843,844,848,850,852],{},[537,845,846],{},[473,847,475],{},[537,849,689],{},[537,851,787],{},[537,853,854],{},"Your UUID for this operation. Sending the same request again with it returns the same operation and never charges twice.",[523,856,857,862,864,866],{},[537,858,859],{},[473,860,861],{},"webhookUrl",[537,863,689],{},[537,865,787],{},[537,867,868,869],{},"Public HTTPS URL told each time the operation stops moving, see ",[482,870,872],{"href":871},"#webhook-callback","Webhook callback",[523,874,875,880,882,884],{},[537,876,877],{},[473,878,879],{},"source",[537,881,689],{},[537,883,787],{},[537,885,886,889,890,893],{},[473,887,888],{},"paste"," (default) or ",[473,891,892],{},"file",": how a Pending Intake line says it arrived",[895,896,898],"h3",{"id":897},"the-credit-ceiling","The credit ceiling",[469,900,901,902,904,905,907,908,911,912,914,915,917,918,920],{},"When ",[473,903,488],{}," makes the worst case of the import (every line a new member, every family bought, every email and phone found) higher than 25 credits, the request must carry ",[473,906,515],{},": without it, it returns ",[473,909,910],{},"400 LIST_INVALID_INPUT"," and nothing is queued. ",[473,913,515],{}," is your consent to spend up to that amount, and the operation stops before a step that would cross it. An import without ",[473,916,488],{}," needs no ceiling: it costs at most the identity of its lines. An import sent without ",[473,919,515],{}," gets its worst case as ceiling, so it may spend up to that amount.",[895,922,924],{"id":923},"deduplication-and-replays","Deduplication and replays",[469,926,927,928,930,931,934,935,937,938,501],{},"Lines naming the same identity with the same ",[473,929,756],{}," are deduplicated: ",[473,932,933],{},"duplicateCount"," gives how many were dropped. Two lines naming the same person under two ",[473,936,756],{}," values stay two lines, and the second one reads ",[473,939,940],{},"already_present",[469,942,943,944,946,947,949,950,714,952,954,955,957,958,501],{},"With ",[473,945,475],{},", sending the same request again returns the operation it created, whatever its state, and charges nothing twice. The same ",[473,948,475],{}," with other Signals, families, ",[473,951,826],{},[473,953,879],{}," returns ",[473,956,910],{},". A cancelled operation stays cancelled: a new run needs a new ",[473,959,475],{},[895,961,963],{"id":962},"pauses-and-how-to-resume","Pauses and how to resume",[469,965,966],{},"The operation pauses instead of failing when it cannot go on, and keeps the work done:",[968,969,970,993,1004],"ul",{},[971,972,973,978,979,982,983,985,986,988,989,992],"li",{},[509,974,975,977],{},[473,976,515],{}," reached"," (",[473,980,981],{},"stopReason: \"max_credits\"","): send the same request again, same ",[473,984,475],{},", with a higher ",[473,987,515],{},". ",[473,990,991],{},"nextStep.minimumMaxCredits"," gives the smallest ceiling that lets it continue.",[971,994,995,978,998,1001,1002,501],{},[509,996,997],{},"Balance too low",[473,999,1000],{},"stopReason: \"balance\"","): add credits, then send the same request again with the same ",[473,1003,475],{},[971,1005,1006,978,1009,1012,1013,501],{},[509,1007,1008],{},"Paused from the app",[473,1010,1011],{},"stopReason: \"paused_by_user\"","): send the same request again with the same ",[473,1014,475],{},[469,1016,1017,1018,1021,1022,1025,1026,753,1029,1032],{},"A paused operation holds the imports queued after it on the same List (",[473,1019,1020],{},"stopReason: \"blocked_by_paused_operation\"",", with ",[473,1023,1024],{},"nextStep.blockingOperationId","): resume or cancel it to let them start. An operation also stops for good when the List reaches its member or Pending Intake limit (",[473,1027,1028],{},"list_member_limit",[473,1030,1031],{},"list_pending_intake_limit","); the lines it did not reach are not charged.",[895,1034,1036],{"id":1035},"lines-that-name-no-one-or-the-wrong-kind","Lines that name no one, or the wrong kind",[469,1038,1039,1040,624,1043,1046,1047,624,1050,1053,1054,1056,1057,624,1059,1062,1063,1066],{},"A line never refuses the whole import. A line naming a company on a people List, or a person on a companies List, reads ",[473,1041,1042],{},"refused",[473,1044,1045],{},"errorCode: \"ENTITY_MISMATCH\"",". A Signal that identifies no one reads ",[473,1048,1049],{},"failed",[473,1051,1052],{},"errorCode: \"LIST_INVALID_INPUT\"",", and a row of a ",[473,1055,717],{}," file with no usable column reads ",[473,1058,1042],{},[473,1060,1061],{},"errorCode: \"NO_INPUT\"",". These lines are free, and ",[482,1064,166],{"href":1065},"\u002Fendpoints\u002Flist-operation#response-structure"," gives them line by line.",[465,1068,1070],{"id":1069},"response-structure","Response structure",[469,1072,1073,1074,1077,1078,1081,1082,1084,1085,1088,1089,1091],{},"The request answers ",[473,1075,1076],{},"202"," at once, with a ",[473,1079,1080],{},"Retry-After: 5"," header. It runs within a 15-second time limit, which a slow ",[473,1083,717],{}," download can cross: past it, it returns ",[473,1086,1087],{},"504",", and the import may have been queued all the same. Always send an ",[473,1090,475],{}," for this reason: the same request sent again with it returns the operation if it exists, or queues it, and never charges twice.",[517,1093,1094,1105],{},[520,1095,1096],{},[523,1097,1098,1101,1103],{},[526,1099,1100],{},"Field",[526,1102,671],{},[526,1104,677],{},[532,1106,1107,1121],{},[523,1108,1109,1114,1116],{},[537,1110,1111],{},[473,1112,1113],{},"success",[537,1115,829],{},[537,1117,1118,1120],{},[473,1119,836],{}," if the operation was queued",[523,1122,1123,1128,1133],{},[537,1124,1125],{},[473,1126,1127],{},"error",[537,1129,1130],{},[473,1131,1132],{},"null",[537,1134,1135,1136,1138],{},"Always ",[473,1137,1132],{}," on success",[1140,1141,1144,1150],"docs-object",{"field":1142,"type":1143},"data","OperationAck",[1145,1146,1147],"docs-object-description",{},[469,1148,1149],{},"The operation queued",[1151,1152,1153],"docs-object-children",{},[517,1154,1155,1165],{},[520,1156,1157],{},[523,1158,1159,1161,1163],{},[526,1160,1100],{},[526,1162,671],{},[526,1164,677],{},[532,1166,1167,1182,1201,1214,1225,1239,1257],{},[523,1168,1169,1173,1175],{},[537,1170,1171],{},[473,1172,475],{},[537,1174,689],{},[537,1176,1177,1178,1181],{},"Operation id (UUID). ",[509,1179,1180],{},"Save it",": it reads, resumes and cancels the operation.",[523,1183,1184,1188,1190],{},[537,1185,1186],{},[473,1187,479],{},[537,1189,689],{},[537,1191,1192,1193,1196,1197,1200],{},"Path that reads the operation: ",[473,1194,1195],{},"GET"," it, with ",[473,1198,1199],{},"?wait=20"," to hold the request until it settles",[523,1202,1203,1208,1211],{},[537,1204,1205],{},[473,1206,1207],{},"totalRows",[537,1209,1210],{},"number",[537,1212,1213],{},"Lines queued after deduplication",[523,1215,1216,1220,1222],{},[537,1217,1218],{},[473,1219,933],{},[537,1221,1210],{},[537,1223,1224],{},"Lines dropped as duplicates of an earlier line",[523,1226,1227,1232,1234],{},[537,1228,1229],{},[473,1230,1231],{},"sourceRows",[537,1233,1210],{},[537,1235,943,1236,1238],{},[473,1237,717],{}," only: the non-empty data rows read from the file",[523,1240,1241,1246,1249],{},[537,1242,1243],{},[473,1244,1245],{},"mapping",[537,1247,1248],{},"object",[537,1250,943,1251,1253,1254],{},[473,1252,717],{}," only: the header each Signal field was read from, for example ",[473,1255,1256],{},"{ \"linkedinUrl\": \"Profile\", \"email\": \"Work email\" }",[523,1258,1259,1263,1265],{},[537,1260,1261],{},[473,1262,100],{},[537,1264,1248],{},[537,1266,1267,1268,1270],{},"The internal record behind the operation, left out of the example below. Its fields may change: read the operation at ",[473,1269,479],{}," instead.",[469,1272,1273,1276,1277,1280,1281,988,1284,1287,1288,1291,1292,1295],{},[473,1274,1275],{},"quotas"," and ",[473,1278,1279],{},"metadata"," are the blocks of every V2 response: see ",[482,1282,234],{"href":1283},"\u002Fendpoints\u002Fusage#response-structure",[473,1285,1286],{},"quotas.creditsConsumed"," is ",[473,1289,1290],{},"0",": the credits of the operation appear in its ",[473,1293,1294],{},"creditsConsumed"," as it runs.",[469,1297,1298,1299,1301,1302,1287,1305,1308,1309,501],{},"Then read the operation at its ",[473,1300,479],{}," until ",[473,1303,1304],{},"clientAction",[473,1306,1307],{},"done",": see ",[482,1310,166],{"href":165},[465,1312,872],{"id":1313},"webhook-callback",[469,1315,943,1316,1318,1319,1322,1323,1325],{},[473,1317,861],{},", that URL receives one ",[473,1320,1321],{},"POST"," each time the operation stops moving: it completed, paused at a ceiling or a low balance, was cancelled, or its outcome became unknown. It receives nothing while the operation runs. The event says which operation changed and carries no member data: read the operation, and its per-line results, at ",[473,1324,479],{}," with your API key.",[469,1327,1328,1329,1332,1333,1335,1336,501],{},"This event is not the lookup callback of the ",[482,1330,1331],{"href":317},"Webhooks guide",": it has its own payload, below, and is sent to ",[473,1334,861],{}," only, never to the workspace webhook URL of ",[509,1337,1338],{},"Settings > Webhooks",[517,1340,1341,1351],{},[520,1342,1343],{},[523,1344,1345,1347,1349],{},[526,1346,1100],{},[526,1348,671],{},[526,1350,677],{},[532,1352,1353,1367,1378,1390,1405,1423,1439,1450],{},[523,1354,1355,1360,1362],{},[537,1356,1357],{},[473,1358,1359],{},"event",[537,1361,689],{},[537,1363,1135,1364],{},[473,1365,1366],{},"list.operation.updated",[523,1368,1369,1373,1375],{},[537,1370,1371],{},[473,1372,475],{},[537,1374,689],{},[537,1376,1377],{},"The operation that changed",[523,1379,1380,1385,1387],{},[537,1381,1382],{},[473,1383,1384],{},"listId",[537,1386,689],{},[537,1388,1389],{},"Its List",[523,1391,1392,1397,1399],{},[537,1393,1394],{},[473,1395,1396],{},"status",[537,1398,689],{},[537,1400,1401,1402,1404],{},"Status of the operation, as ",[482,1403,166],{"href":1065}," gives it",[523,1406,1407,1411,1413],{},[537,1408,1409],{},[473,1410,1304],{},[537,1412,689],{},[537,1414,1415,753,1417,714,1420],{},[473,1416,1307],{},[473,1418,1419],{},"resume",[473,1421,1422],{},"reconcile",[523,1424,1425,1430,1433],{},[537,1426,1427],{},[473,1428,1429],{},"stopReason",[537,1431,1432],{},"string | null",[537,1434,1435,1436,1438],{},"Why it stopped, ",[473,1437,1132],{}," once completed",[523,1440,1441,1445,1447],{},[537,1442,1443],{},[473,1444,479],{},[537,1446,689],{},[537,1448,1449],{},"Path that reads the operation",[523,1451,1452,1457,1459],{},[537,1453,1454],{},[473,1455,1456],{},"occurredAt",[537,1458,689],{},[537,1460,1461],{},"When the event was sent (ISO 8601)",[469,1463,1464,1465,1468,1469,1471,1472,1475,1476,1479,1480,1483,1484,1487,1488,501],{},"The request is JSON and its ",[473,1466,1467],{},"x-reversecontact-event"," header names the event, ",[473,1470,1366],{},". Answer with a ",[473,1473,1474],{},"2xx"," within 10 seconds. A timeout, a ",[473,1477,1478],{},"408",", a ",[473,1481,1482],{},"429"," or a ",[473,1485,1486],{},"5xx"," is tried again twice, after 2 then 5 seconds; a redirect is never followed. Each state is sent once, so a receiver that missed it can always read the operation at ",[473,1489,479],{},[469,1491,1492,1493,1496],{},"The URL must be public HTTPS: a private, local or unresolvable host returns ",[473,1494,1495],{},"400 WEBHOOK_URL_UNREACHABLE"," and nothing is queued. It is checked again before each delivery.",[465,1498,1500],{"id":1499},"errors","Errors",[517,1502,1503,1516],{},[520,1504,1505],{},[523,1506,1507,1510,1513],{},[526,1508,1509],{},"Status",[526,1511,1512],{},"Code",[526,1514,1515],{},"Meaning",[532,1517,1518,1543,1559,1577,1592,1606,1623,1640,1655],{},[523,1519,1520,1525,1530],{},[537,1521,1522],{},[473,1523,1524],{},"400",[537,1526,1527],{},[473,1528,1529],{},"LIST_INVALID_INPUT",[537,1531,1532,1533,1276,1535,753,1537,1539,1540,1542],{},"Neither or both of ",[473,1534,713],{},[473,1536,717],{},[473,1538,515],{}," missing above 25 credits, a family the List cannot hold, or an ",[473,1541,475],{}," sent again with another request",[523,1544,1545,1549,1554],{},[537,1546,1547],{},[473,1548,1524],{},[537,1550,1551],{},[473,1552,1553],{},"WEBHOOK_URL_UNREACHABLE",[537,1555,1556,1558],{},[473,1557,861],{}," is not a public HTTPS URL",[523,1560,1561,1566,1571],{},[537,1562,1563],{},[473,1564,1565],{},"403",[537,1567,1568],{},[473,1569,1570],{},"INSUFFICIENT_PERMISSIONS",[537,1572,1573,1574,1576],{},"The key lacks ",[473,1575,178],{},", or the permission of what the import buys",[523,1578,1579,1584,1589],{},[537,1580,1581],{},[473,1582,1583],{},"404",[537,1585,1586],{},[473,1587,1588],{},"LIST_NOT_FOUND",[537,1590,1591],{},"No List with this id in your workspace",[523,1593,1594,1598,1603],{},[537,1595,1596],{},[473,1597,1583],{},[537,1599,1600],{},[473,1601,1602],{},"LISTS_NOT_ACTIVATED",[537,1604,1605],{},"The workspace has never had a List: create one first",[523,1607,1608,1613,1618],{},[537,1609,1610],{},[473,1611,1612],{},"422",[537,1614,1615],{},[473,1616,1617],{},"BULK_JOB_CSV_PARSE_ERROR",[537,1619,614,1620,1622],{},[473,1621,717],{}," file could not be read: not a public HTTPS URL, no header row, no recognized column, too many rows, or over 25 MiB",[523,1624,1625,1630,1635],{},[537,1626,1627],{},[473,1628,1629],{},"502",[537,1631,1632],{},[473,1633,1634],{},"LIST_JOB_ENGINE_ERROR",[537,1636,1637,1638],{},"The List service is briefly unavailable: send the same request again, with the same ",[473,1639,475],{},[523,1641,1642,1647,1652],{},[537,1643,1644],{},[473,1645,1646],{},"503",[537,1648,1649],{},[473,1650,1651],{},"BULK_QUEUE_UNAVAILABLE",[537,1653,1654],{},"The import queue is busy: retry shortly",[523,1656,1657,1661,1666],{},[537,1658,1659],{},[473,1660,1087],{},[537,1662,1663],{},[473,1664,1665],{},"GATEWAY_TIMEOUT",[537,1667,1668,1669],{},"The request ran out of time after 15 seconds: send it again with the same ",[473,1670,475],{},[465,1672,1674],{"id":1673},"code-examples","Code examples",[1676,1677,1679,1690,1699],"code-group",{"title":1678},"Code Examples",[1680,1681,1688],"pre",{"className":1682,"code":1684,"filename":1685,"language":1686,"meta":1687},[1683],"language-bash","curl -X POST https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Flists\u002F3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\u002Fintake\u002Fsignals \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"operationId\": \"c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\",\n    \"signals\": [\n      { \"linkedinUrl\": \"https:\u002F\u002Fwww.social.com\u002Fin\u002Fjanedoe\", \"externalId\": \"crm-001\" },\n      { \"email\": \"john.smith@acme.com\", \"externalId\": \"crm-002\" }\n    ],\n    \"families\": [\"contact_email\"],\n    \"maxCredits\": 100,\n    \"webhookUrl\": \"https:\u002F\u002Fexample.com\u002Fhooks\u002Freversecontact\"\n  }'\n","cURL","bash","",[473,1689,1684],{"__ignoreMap":1687},[1680,1691,1697],{"className":1692,"code":1694,"filename":1695,"language":1696,"meta":1687},[1693],"language-javascript","const KEY = \"YOUR_API_KEY\";\nconst BASE = \"https:\u002F\u002Fapi.reversecontact.com\";\nconst listId = \"3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\";\n\n\u002F\u002F Queue the import, then follow it until it no longer moves.\nconst queued = await fetch(`${BASE}\u002Fv2\u002Flists\u002F${listId}\u002Fintake\u002Fsignals`, {\n  method: \"POST\",\n  headers: { \"Authorization\": `Bearer ${KEY}`, \"Content-Type\": \"application\u002Fjson\" },\n  body: JSON.stringify({\n    operationId: crypto.randomUUID(),\n    signals: [\n      { linkedinUrl: \"https:\u002F\u002Fwww.social.com\u002Fin\u002Fjanedoe\", externalId: \"crm-001\" },\n      { email: \"john.smith@acme.com\", externalId: \"crm-002\" }\n    ],\n    families: [\"contact_email\"],\n    maxCredits: 100\n  })\n});\nconst { data: ack } = await queued.json();\n\nlet operation;\ndo {\n  const response = await fetch(`${BASE}${ack.pollUrl}?wait=20`, {\n    headers: { \"Authorization\": `Bearer ${KEY}` }\n  });\n  operation = (await response.json()).data;\n} while (operation.clientAction === \"poll\");\n\nconsole.log(operation.status, `${operation.creditsConsumed} credits`, operation.nextStep?.message ?? \"\");\n","JavaScript","javascript",[473,1698,1694],{"__ignoreMap":1687},[1680,1700,1706],{"className":1701,"code":1703,"filename":1704,"language":1705,"meta":1687},[1702],"language-python","import uuid\nimport requests\n\nKEY = \"YOUR_API_KEY\"\nBASE = \"https:\u002F\u002Fapi.reversecontact.com\"\nlist_id = \"3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\"\nheaders = {\"Authorization\": f\"Bearer {KEY}\"}\n\nack = requests.post(\n    f\"{BASE}\u002Fv2\u002Flists\u002F{list_id}\u002Fintake\u002Fsignals\",\n    headers=headers,\n    json={\n        \"operationId\": str(uuid.uuid4()),\n        \"signals\": [\n            {\"linkedinUrl\": \"https:\u002F\u002Fwww.social.com\u002Fin\u002Fjanedoe\", \"externalId\": \"crm-001\"},\n            {\"email\": \"john.smith@acme.com\", \"externalId\": \"crm-002\"}\n        ],\n        \"families\": [\"contact_email\"],\n        \"maxCredits\": 100\n    }\n).json()[\"data\"]\n\nwhile True:\n    operation = requests.get(f\"{BASE}{ack['pollUrl']}\", headers=headers, params={\"wait\": 20}, timeout=30).json()[\"data\"]\n    if operation[\"clientAction\"] != \"poll\":\n        break\n\nprint(operation[\"status\"], operation[\"creditsConsumed\"], \"credits\")\n","Python","python",[473,1707,1703],{"__ignoreMap":1687},[465,1709,1711],{"id":1710},"example-response","Example response",[1676,1713,1715,1724],{"title":1714},"Example Response",[1680,1716,1722],{"className":1717,"code":1719,"filename":1720,"language":1721,"meta":1687},[1718],"language-json","{\n  \"success\": true,\n  \"data\": {\n    \"operationId\": \"c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\",\n    \"pollUrl\": \"\u002Fv2\u002Flists\u002F3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\u002Foperations\u002Fc4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\u002Fprogress\",\n    \"totalRows\": 2,\n    \"duplicateCount\": 0\n  },\n  \"error\": null,\n  \"quotas\": {\n    \"creditsConsumed\": 0,\n    \"workspace\": {\n      \"id\": \"ws_abc123\",\n      \"credits\": { \"total\": 10000, \"used\": 4522, \"left\": 5478 }\n    }\n  },\n  \"metadata\": {\n    \"requestId\": \"b1d8124d-e074-4d7b-9a14-fba9bfe74625\",\n    \"executionTimeMs\": 88\n  }\n}\n","202 - Queued","json",[473,1723,1719],{"__ignoreMap":1687},[1680,1725,1729],{"className":1726,"code":1727,"filename":1728,"language":1721,"meta":1687},[1718],"{\n  \"event\": \"list.operation.updated\",\n  \"operationId\": \"c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\",\n  \"listId\": \"3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\",\n  \"status\": \"completed\",\n  \"clientAction\": \"done\",\n  \"stopReason\": null,\n  \"pollUrl\": \"\u002Fv2\u002Flists\u002F3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\u002Foperations\u002Fc4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\u002Fprogress\",\n  \"occurredAt\": \"2026-10-28T09:21:40.000Z\"\n}\n","Webhook event",[473,1730,1727],{"__ignoreMap":1687},{"title":1687,"searchDepth":1732,"depth":1732,"links":1733},3,[1734,1735,1736,1737,1743,1744,1745,1746,1747],{"id":19,"depth":298,"text":467},{"id":504,"depth":298,"text":262},{"id":658,"depth":298,"text":659},{"id":702,"depth":298,"text":703,"children":1738},[1739,1740,1741,1742],{"id":897,"depth":1732,"text":898},{"id":923,"depth":1732,"text":924},{"id":962,"depth":1732,"text":963},{"id":1035,"depth":1732,"text":1036},{"id":1069,"depth":298,"text":1070},{"id":1313,"depth":298,"text":872},{"id":1499,"depth":298,"text":1500},{"id":1673,"depth":298,"text":1674},{"id":1710,"depth":298,"text":1711},"Import up to 25,000 Signals or CSV rows into a List, enrich members within a credit budget, and track progress by polling or webhook.","md","2026-11-04",{},true,"\u002Fdocs\u002Fguides\u002Flists,\u002Fdocs\u002Fguides\u002Fbuild-a-list,\u002Fdocs\u002Fendpoints\u002Flist-operation,\u002Fdocs\u002Fendpoints\u002Flist-operation-cancel",{"title":144,"description":1748},"endpoints\u002Flist-intake-signals","-EaH9IvjcybLkx09O1xqtaTolcuPwjYE_Z20wDdRXLk",1793830202160]