[{"data":1,"prerenderedAt":1825},["ShallowReactive",2],{"docs-navigation":3,"docs-\u002Fendpoints\u002Flist-operation":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":166,"audience":10,"badgeColor":10,"badgeLabel":10,"body":461,"category":30,"description":1816,"endpointId":168,"extension":1817,"family":125,"lastVerified":1818,"links":10,"meta":1819,"navigation":1820,"order":167,"path":165,"relatedArticles":1821,"requiresFlag":10,"seo":1822,"status":11,"stem":1823,"subfamily":146,"__hash__":1824},"docs\u002Fendpoints\u002Flist-operation.md",{"type":462,"value":463,"toc":1803},"minimark",[464,468,494,505,509,555,559,566,571,618,622,708,722,726,751,824,828,876,1711,1730,1736,1740,1773,1777,1784],[465,466,467],"h2",{"id":19},"Introduction",[469,470,471,472,476,477,481,482,485,486,489,490,493],"p",{},"The Read a List operation endpoint reads an operation started by an ",[473,474,475],"a",{"href":143},"import",": it is the ",[478,479,480],"code",{},"pollUrl"," of the import. It says how far the operation is, what it has charged, and what to do next with ",[478,483,484],{},"clientAction",". With ",[478,487,488],{},"rows=true",", it also returns the result of each line you sent, with your ",[478,491,492],{},"externalId"," and the member it became.",[469,495,496,497,501,502,504],{},"Reading an operation is ",[498,499,500],"strong",{},"free",", also at a zero balance, and never counted against your rate limits, so you can follow a long import at the pace it asks for. Any key of the workspace with the ",[478,503,178],{}," permission can read it.",[465,506,508],{"id":507},"authorization","Authorization",[510,511,512,531],"table",{},[513,514,515],"thead",{},[516,517,518,522,525,528],"tr",{},[519,520,521],"th",{},"Name",[519,523,524],{},"Type",[519,526,527],{},"Required",[519,529,530],{},"Description",[532,533,534],"tbody",{},[516,535,536,542,545,548],{},[537,538,539],"td",{},[478,540,541],{},"apikey",[537,543,544],{},"string",[537,546,547],{},"Yes",[537,549,550,551,554],{},"Your API key from the developer dashboard. Pass it via ",[478,552,553],{},"Authorization: Bearer YOUR_API_KEY"," header.",[465,556,558],{"id":557},"request","Request",[469,560,561,562,565],{},"The route is ",[478,563,564],{},"GET \u002Fv2\u002Flists\u002F:listId\u002Foperations\u002F:operationId\u002Fprogress",".",[567,568,570],"h3",{"id":569},"path-parameters","Path parameters",[510,572,573,585],{},[513,574,575],{},[516,576,577,579,581,583],{},[519,578,521],{},[519,580,524],{},[519,582,527],{},[519,584,530],{},[532,586,587,601],{},[516,588,589,594,596,598],{},[537,590,591],{},[478,592,593],{},"listId",[537,595,544],{},[537,597,547],{},[537,599,600],{},"List id (UUID)",[516,602,603,608,610,612],{},[537,604,605],{},[478,606,607],{},"operationId",[537,609,544],{},[537,611,547],{},[537,613,614,615,617],{},"The ",[478,616,607],{}," of the import acknowledgement",[567,619,621],{"id":620},"query-parameters","Query Parameters",[510,623,624,636],{},[513,625,626],{},[516,627,628,630,632,634],{},[519,629,521],{},[519,631,524],{},[519,633,527],{},[519,635,530],{},[532,637,638,654,671,688],{},[516,639,640,645,648,651],{},[537,641,642],{},[478,643,644],{},"wait",[537,646,647],{},"integer",[537,649,650],{},"No",[537,652,653],{},"Hold the request up to this many seconds, 0 to 20, while the operation runs. It answers as soon as the operation settles, pauses or stops, or with the operation still running when the wait ends. Defaults to 0.",[516,655,656,661,663,665],{},[537,657,658],{},[478,659,660],{},"rows",[537,662,544],{},[537,664,650],{},[537,666,667,670],{},[478,668,669],{},"true"," adds one page of per-line results",[516,672,673,678,680,682],{},[537,674,675],{},[478,676,677],{},"perPage",[537,679,647],{},[537,681,650],{},[537,683,684,685,687],{},"With ",[478,686,488],{},": lines per page, from 1 to 1,000. Defaults to 200.",[516,689,690,695,697,699],{},[537,691,692],{},[478,693,694],{},"cursor",[537,696,544],{},[537,698,650],{},[537,700,684,701,703,704,707],{},[478,702,488],{},": the ",[478,705,706],{},"rows.nextCursor"," of the previous page",[469,709,710,712,713,715,716,718,719,565],{},[478,711,694],{}," and ",[478,714,677],{}," without ",[478,717,488],{}," return ",[478,720,721],{},"400 LIST_INVALID_INPUT",[567,723,725],{"id":724},"how-to-follow-an-operation","How to follow an operation",[469,727,728,729,731,732,735,736,739,740,743,744,747,748,750],{},"Read the operation while ",[478,730,484],{}," is ",[478,733,734],{},"poll",", with ",[478,737,738],{},"wait=20"," and an HTTP client timeout above it, for example 30 seconds. Start two reads at least ",[478,741,742],{},"pollAfterSeconds"," apart (the ",[478,745,746],{},"Retry-After"," header carries the same value): a held read already lasts longer, so the next one starts right away. Then act on ",[478,749,484],{},":",[510,752,753,764],{},[513,754,755],{},[516,756,757,761],{},[519,758,759],{},[478,760,484],{},[519,762,763],{},"What to do",[532,765,766,775,792,814],{},[516,767,768,772],{},[537,769,770],{},[478,771,734],{},[537,773,774],{},"The operation runs: read it again",[516,776,777,782],{},[537,778,779],{},[478,780,781],{},"done",[537,783,784,785,788,789,791],{},"It ended. With ",[478,786,787],{},"completed",", the data can be read in the List; read ",[478,790,660],{}," for the line results",[516,793,794,799],{},[537,795,796],{},[478,797,798],{},"resume",[537,800,801,802,805,806,809,810],{},"It paused: ",[478,803,804],{},"stopReason"," says why and ",[478,807,808],{},"nextStep"," what to do, see ",[473,811,813],{"href":812},"\u002Fendpoints\u002Flist-intake-signals#pauses-and-how-to-resume","Pauses and how to resume",[516,815,816,821],{},[537,817,818],{},[478,819,820],{},"reconcile",[537,822,823],{},"The outcome is unknown: read the List before doing anything, and never send the import again blindly",[465,825,827],{"id":826},"response-structure","Response structure",[510,829,830,841],{},[513,831,832],{},[516,833,834,837,839],{},[519,835,836],{},"Field",[519,838,524],{},[519,840,530],{},[532,842,843,858],{},[516,844,845,850,853],{},[537,846,847],{},[478,848,849],{},"success",[537,851,852],{},"boolean",[537,854,855,857],{},[478,856,669],{}," if the request was processed successfully",[516,859,860,865,870],{},[537,861,862],{},[478,863,864],{},"error",[537,866,867],{},[478,868,869],{},"null",[537,871,872,873,875],{},"Always ",[478,874,869],{}," on success",[877,878,881,887],"docs-object",{"field":879,"type":880},"data","ListOperation",[882,883,884],"docs-object-description",{},[469,885,886],{},"The operation",[888,889,890,1264,1372,1479],"docs-object-children",{},[510,891,892,902],{},[513,893,894],{},[516,895,896,898,900],{},[519,897,836],{},[519,899,524],{},[519,901,530],{},[532,903,904,915,926,944,985,1004,1017,1029,1048,1060,1078,1091,1105,1116,1151,1169,1204,1216,1228,1240,1252],{},[516,905,906,910,912],{},[537,907,908],{},[478,909,607],{},[537,911,544],{},[537,913,914],{},"Operation id",[516,916,917,921,923],{},[537,918,919],{},[478,920,593],{},[537,922,544],{},[537,924,925],{},"List id",[516,927,928,933,935],{},[537,929,930],{},[478,931,932],{},"kind",[537,934,544],{},[537,936,937,940,941],{},[478,938,939],{},"list_intake_persons"," or ",[478,942,943],{},"list_intake_companies",[516,945,946,951,953],{},[537,947,948],{},[478,949,950],{},"status",[537,952,544],{},[537,954,955,958,959,958,962,958,965,958,968,958,970,958,973,958,976,958,979,940,982],{},[478,956,957],{},"queued",", ",[478,960,961],{},"running",[478,963,964],{},"paused",[478,966,967],{},"stopped_budget",[478,969,787],{},[478,971,972],{},"partial",[478,974,975],{},"failed",[478,977,978],{},"cancelled",[478,980,981],{},"refused",[478,983,984],{},"unknown",[516,986,987,991,993],{},[537,988,989],{},[478,990,484],{},[537,992,544],{},[537,994,995,958,997,958,999,940,1001,1003],{},[478,996,734],{},[478,998,798],{},[478,1000,781],{},[478,1002,820],{},": what to do next",[516,1005,1006,1011,1014],{},[537,1007,1008],{},[478,1009,1010],{},"creditsConsumed",[537,1012,1013],{},"number",[537,1015,1016],{},"Credits charged so far",[516,1018,1019,1024,1026],{},[537,1020,1021],{},[478,1022,1023],{},"creditsPending",[537,1025,1013],{},[537,1027,1028],{},"Credits reserved by steps in flight",[516,1030,1031,1036,1038],{},[537,1032,1033],{},[478,1034,1035],{},"creditsEstimated",[537,1037,1013],{},[537,1039,1040,1041,1044,1045],{},"Credits reserved when the operation was created: ",[478,1042,1043],{},"0"," for an import, which spends up to ",[478,1046,1047],{},"maxCredits",[516,1049,1050,1054,1057],{},[537,1051,1052],{},[478,1053,1047],{},[537,1055,1056],{},"number | null",[537,1058,1059],{},"The ceiling of the operation",[516,1061,1062,1067,1069],{},[537,1063,1064],{},[478,1065,1066],{},"estimatedSeconds",[537,1068,1056],{},[537,1070,1071,1072,1074,1075,1077],{},"Seconds left while it runs, ",[478,1073,1043],{}," once done, ",[478,1076,869],{}," when not known yet",[516,1079,1080,1085,1088],{},[537,1081,1082],{},[478,1083,1084],{},"estimateBlockedUntil",[537,1086,1087],{},"string | null",[537,1089,1090],{},"When the daily extraction limit holds the operation: the next 00:00 UTC, when it resumes",[516,1092,1093,1097,1099],{},[537,1094,1095],{},[478,1096,742],{},[537,1098,1013],{},[537,1100,1101,1102,1104],{},"Seconds to wait before reading again, ",[478,1103,1043],{}," once you can stop",[516,1106,1107,1111,1113],{},[537,1108,1109],{},[478,1110,480],{},[537,1112,544],{},[537,1114,1115],{},"Path of this endpoint for the operation",[516,1117,1118,1123,1126],{},[537,1119,1120],{},[478,1121,1122],{},"followUp",[537,1124,1125],{},"object",[537,1127,1128,1129,1132,1133,1136,1137,1140,1141,1132,1144,958,1146,1148,1149],{},"The same follow-up for an agent: ",[478,1130,1131],{},"tool"," (",[478,1134,1135],{},"get_list_operation",", the ",[473,1138,1139],{"href":293},"MCP"," tool), its ",[478,1142,1143],{},"arguments",[478,1145,593],{},[478,1147,607],{},") and ",[478,1150,742],{},[516,1152,1153,1158,1160],{},[537,1154,1155],{},[478,1156,1157],{},"replay",[537,1159,1125],{},[537,1161,872,1162,1165,1166,1168],{},[478,1163,1164],{},"{ \"reuseOperationId\": true, \"startNewWork\": false, \"debitAgain\": false }",": sending the import again with the same ",[478,1167,607],{}," starts no new work and charges nothing twice",[516,1170,1171,1175,1177],{},[537,1172,1173],{},[478,1174,804],{},[537,1176,1087],{},[537,1178,1179,1180,958,1183,958,1186,958,1189,1192,1193,958,1196,958,1199,940,1202],{},"Why it is not running: ",[478,1181,1182],{},"max_credits",[478,1184,1185],{},"balance",[478,1187,1188],{},"blocked_by_paused_operation",[478,1190,1191],{},"paused_by_user"," (paused from the app), ",[478,1194,1195],{},"list_member_limit",[478,1197,1198],{},"list_pending_intake_limit",[478,1200,1201],{},"insufficient_credits",[478,1203,978],{},[516,1205,1206,1211,1213],{},[537,1207,1208],{},[478,1209,1210],{},"errorMessage",[537,1212,1087],{},[537,1214,1215],{},"What failed, when it failed",[516,1217,1218,1223,1225],{},[537,1219,1220],{},[478,1221,1222],{},"startedAt",[537,1224,1087],{},[537,1226,1227],{},"Start date (ISO 8601)",[516,1229,1230,1235,1237],{},[537,1231,1232],{},[478,1233,1234],{},"completedAt",[537,1236,1087],{},[537,1238,1239],{},"End date (ISO 8601), once the data can be read",[516,1241,1242,1247,1249],{},[537,1243,1244],{},[478,1245,1246],{},"createdAt",[537,1248,1087],{},[537,1250,1251],{},"Date the operation was created (ISO 8601)",[516,1253,1254,1259,1261],{},[537,1255,1256],{},[478,1257,1258],{},"updatedAt",[537,1260,1087],{},[537,1262,1263],{},"Date of its last change (ISO 8601)",[877,1265,1268,1273],{"field":1266,"type":1267},"progress","Progress",[882,1269,1270],{},[469,1271,1272],{},"Lines of the operation",[888,1274,1275],{},[510,1276,1277,1287],{},[513,1278,1279],{},[516,1280,1281,1283,1285],{},[519,1282,836],{},[519,1284,524],{},[519,1286,530],{},[532,1288,1289,1301,1313,1325,1336,1348,1360],{},[516,1290,1291,1296,1298],{},[537,1292,1293],{},[478,1294,1295],{},"total",[537,1297,1013],{},[537,1299,1300],{},"Lines in the operation",[516,1302,1303,1308,1310],{},[537,1304,1305],{},[478,1306,1307],{},"processed",[537,1309,1013],{},[537,1311,1312],{},"Lines processed",[516,1314,1315,1320,1322],{},[537,1316,1317],{},[478,1318,1319],{},"succeeded",[537,1321,1013],{},[537,1323,1324],{},"Lines that found their member and every family asked for",[516,1326,1327,1331,1333],{},[537,1328,1329],{},[478,1330,975],{},[537,1332,1013],{},[537,1334,1335],{},"Lines that failed, matched no one, or found their member but not a family asked for (an email not found, for example)",[516,1337,1338,1343,1345],{},[537,1339,1340],{},[478,1341,1342],{},"skipped",[537,1344,1013],{},[537,1346,1347],{},"Lines skipped",[516,1349,1350,1355,1357],{},[537,1351,1352],{},[478,1353,1354],{},"remaining",[537,1356,1013],{},[537,1358,1359],{},"Lines left",[516,1361,1362,1367,1369],{},[537,1363,1364],{},[478,1365,1366],{},"unknownCount",[537,1368,1013],{},[537,1370,1371],{},"Lines whose outcome is unknown",[877,1373,1375,1383],{"field":808,"type":1374},"NextStep",[882,1376,1377],{},[469,1378,1379,1380,1382],{},"What to do after a stop, ",[478,1381,869],{}," otherwise",[888,1384,1385],{},[510,1386,1387,1397],{},[513,1388,1389],{},[516,1390,1391,1393,1395],{},[519,1392,836],{},[519,1394,524],{},[519,1396,530],{},[532,1398,1399,1425,1437,1449,1467],{},[516,1400,1401,1406,1408],{},[537,1402,1403],{},[478,1404,1405],{},"action",[537,1407,544],{},[537,1409,1410,958,1413,958,1416,1418,1419,940,1422],{},[478,1411,1412],{},"raise_max_credits_and_resume",[478,1414,1415],{},"top_up_and_resume",[478,1417,798],{}," (after a pause from the app), ",[478,1420,1421],{},"resume_or_cancel_blocking_operation",[478,1423,1424],{},"none",[516,1426,1427,1432,1434],{},[537,1428,1429],{},[478,1430,1431],{},"message",[537,1433,544],{},[537,1435,1436],{},"The next step, in a sentence you can show",[516,1438,1439,1444,1446],{},[537,1440,1441],{},[478,1442,1443],{},"requiredCredits",[537,1445,1013],{},[537,1447,1448],{},"Worst-case credits of the step that stopped",[516,1450,1451,1456,1458],{},[537,1452,1453],{},[478,1454,1455],{},"minimumMaxCredits",[537,1457,1013],{},[537,1459,1460,1461,1463,1464,1466],{},"After a ",[478,1462,1182],{}," stop: the smallest ",[478,1465,1047],{}," that lets it continue",[516,1468,1469,1474,1476],{},[537,1470,1471],{},[478,1472,1473],{},"blockingOperationId",[537,1475,544],{},[537,1477,1478],{},"The paused operation this one waits for",[877,1480,1482,1491],{"field":660,"type":1481},"LineResults",[882,1483,1484],{},[469,1485,684,1486,1488,1489],{},[478,1487,488],{},", one page of line results; absent without ",[478,1490,488],{},[888,1492,1493,1525],{},[510,1494,1495,1505],{},[513,1496,1497],{},[516,1498,1499,1501,1503],{},[519,1500,836],{},[519,1502,524],{},[519,1504,530],{},[532,1506,1507],{},[516,1508,1509,1514,1516],{},[537,1510,1511],{},[478,1512,1513],{},"nextCursor",[537,1515,1087],{},[537,1517,1518,1519,1521,1522,1524],{},"Send it back as ",[478,1520,694],{}," for the next page, ",[478,1523,869],{}," on the last page",[877,1526,1529,1534],{"field":1527,"type":1528},"items","LineResult[]",[882,1530,1531],{},[469,1532,1533],{},"One entry per line, in request order",[888,1535,1536],{},[510,1537,1538,1548],{},[513,1539,1540],{},[516,1541,1542,1544,1546],{},[519,1543,836],{},[519,1545,524],{},[519,1547,530],{},[532,1549,1550,1573,1585,1623,1634,1646,1673,1699],{},[516,1551,1552,1557,1559],{},[537,1553,1554],{},[478,1555,1556],{},"index",[537,1558,1056],{},[537,1560,1561,1562,1565,1566,1569,1570,1572],{},"Position of the line in ",[478,1563,1564],{},"signals",", or among the non-empty data rows of a ",[478,1567,1568],{},"sourceUrl"," file, from 0; ",[478,1571,869],{}," for a file sent from the app",[516,1574,1575,1580,1582],{},[537,1576,1577],{},[478,1578,1579],{},"rowNumber",[537,1581,1013],{},[537,1583,1584],{},"Line number in the operation",[516,1586,1587,1592,1594],{},[537,1588,1589],{},[478,1590,1591],{},"outcome",[537,1593,544],{},[537,1595,1596,1599,1600,958,1603,958,1606,1609,1610,958,1613,958,1615,958,1617,1620,1621],{},[478,1597,1598],{},"pending"," (not processed yet), ",[478,1601,1602],{},"added",[478,1604,1605],{},"already_present",[478,1607,1608],{},"resolved"," (the member was found, but the line does not say whether it added it: after a restart, or when a requested family could not be bought), ",[478,1611,1612],{},"not_found",[478,1614,981],{},[478,1616,975],{},[478,1618,1619],{},"not_reached"," (not started before a cancel) or ",[478,1622,984],{},[516,1624,1625,1629,1631],{},[537,1626,1627],{},[478,1628,492],{},[537,1630,1087],{},[537,1632,1633],{},"Your identifier, as sent",[516,1635,1636,1641,1643],{},[537,1637,1638],{},[478,1639,1640],{},"memberId",[537,1642,1087],{},[537,1644,1645],{},"The member the line names",[516,1647,1648,1653,1655],{},[537,1649,1650],{},[478,1651,1652],{},"errorCode",[537,1654,1087],{},[537,1656,1657,1658,958,1661,1664,1665,1668,1669,1672],{},"What went wrong: for example ",[478,1659,1660],{},"NOT_FOUND",[478,1662,1663],{},"ENTITY_MISMATCH"," (a company on a people List, or the reverse), ",[478,1666,1667],{},"DATA_SUBJECT_BLOCKED"," (the person asked us to stop processing their data), or ",[478,1670,1671],{},"CONTACT_EMAIL_NOT_FOUND"," when the member was found but a family could not be bought",[516,1674,1675,1680,1682],{},[537,1676,1677],{},[478,1678,1679],{},"reason",[537,1681,1087],{},[537,1683,1684,1685,1687,1688,958,1690,958,1693,1695,1696,1698],{},"How the line ended, once it ended: ",[478,1686,787],{}," when every requested family was bought, ",[478,1689,1612],{},[478,1691,1692],{},"data_subject_blocked",[478,1694,984],{},", or what the family lookup returned. ",[478,1697,869],{}," for a line without families that found its member.",[516,1700,1701,1706,1708],{},[537,1702,1703],{},[478,1704,1705],{},"signal",[537,1707,1125],{},[537,1709,1710],{},"The identifiers the line was sent with",[469,1712,1713,712,1716,1719,1720,1723,1724,731,1727,1729],{},[478,1714,1715],{},"quotas",[478,1717,1718],{},"metadata"," are the blocks of every V2 response: see ",[473,1721,234],{"href":1722},"\u002Fendpoints\u002Fusage#response-structure",". ",[478,1725,1726],{},"quotas.creditsConsumed",[478,1728,1043],{}," for the read itself.",[469,1731,1732,1733,565],{},"An operation that does not belong to this List and workspace returns ",[478,1734,1735],{},"404 LIST_OPERATION_NOT_FOUND",[465,1737,1739],{"id":1738},"code-examples","Code examples",[1741,1742,1744,1755,1764],"code-group",{"title":1743},"Code Examples",[1745,1746,1753],"pre",{"className":1747,"code":1749,"filename":1750,"language":1751,"meta":1752},[1748],"language-bash","curl \"https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Flists\u002F3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\u002Foperations\u002Fc4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\u002Fprogress?wait=20\" \\\n  -H \"Authorization: Bearer YOUR_API_KEY\"\n","cURL","bash","",[478,1754,1749],{"__ignoreMap":1752},[1745,1756,1762],{"className":1757,"code":1759,"filename":1760,"language":1761,"meta":1752},[1758],"language-javascript","\u002F\u002F Once the import is done, read the result of every line.\nconst KEY = \"YOUR_API_KEY\";\nconst pollUrl = \"\u002Fv2\u002Flists\u002F3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\u002Foperations\u002Fc4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\u002Fprogress\";\nconst lines = [];\nlet cursor = null;\n\ndo {\n  const url = new URL(`https:\u002F\u002Fapi.reversecontact.com${pollUrl}`);\n  url.searchParams.set(\"rows\", \"true\");\n  url.searchParams.set(\"perPage\", \"1000\");\n  if (cursor) url.searchParams.set(\"cursor\", cursor);\n\n  const response = await fetch(url, { headers: { \"Authorization\": `Bearer ${KEY}` } });\n  const { data } = await response.json();\n  lines.push(...data.rows.items);\n  cursor = data.rows.nextCursor;\n} while (cursor);\n\nfor (const line of lines) console.log(line.externalId, line.outcome, line.memberId);\n","JavaScript","javascript",[478,1763,1759],{"__ignoreMap":1752},[1745,1765,1771],{"className":1766,"code":1768,"filename":1769,"language":1770,"meta":1752},[1767],"language-python","import requests\n\nurl = \"https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Flists\u002F3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\u002Foperations\u002Fc4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\u002Fprogress\"\noperation = requests.get(\n    url,\n    headers={\"Authorization\": \"Bearer YOUR_API_KEY\"},\n    params={\"wait\": 20},\n    timeout=30\n).json()[\"data\"]\n\nprint(operation[\"status\"], operation[\"clientAction\"])\nif operation[\"clientAction\"] == \"resume\":\n    print(operation[\"nextStep\"][\"message\"])\n","Python","python",[478,1772,1768],{"__ignoreMap":1752},[465,1774,1776],{"id":1775},"example-response","Example response",[469,1778,1779,1780,1783],{},"The second example reads the import of ",[473,1781,144],{"href":1782},"\u002Fendpoints\u002Flist-intake-signals#code-examples"," once done: Jane Doe is added (1 credit) and her email is found (3 credits). John Smith is already on the List, and the email of his Signal becomes his work email, free.",[1741,1785,1787,1796],{"title":1786},"Example Response",[1745,1788,1794],{"className":1789,"code":1791,"filename":1792,"language":1793,"meta":1752},[1790],"language-json","{\n  \"success\": true,\n  \"data\": {\n    \"operationId\": \"c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\",\n    \"listId\": \"3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\",\n    \"kind\": \"list_intake_persons\",\n    \"status\": \"stopped_budget\",\n    \"clientAction\": \"resume\",\n    \"progress\": {\n      \"processed\": 312,\n      \"total\": 500,\n      \"succeeded\": 298,\n      \"failed\": 14,\n      \"skipped\": 0,\n      \"remaining\": 188,\n      \"unknownCount\": 0\n    },\n    \"creditsConsumed\": 998,\n    \"creditsPending\": 0,\n    \"creditsEstimated\": 0,\n    \"maxCredits\": 1000,\n    \"estimatedSeconds\": null,\n    \"estimateBlockedUntil\": null,\n    \"pollAfterSeconds\": 0,\n    \"pollUrl\": \"\u002Fv2\u002Flists\u002F3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\u002Foperations\u002Fc4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\u002Fprogress\",\n    \"followUp\": {\n      \"tool\": \"get_list_operation\",\n      \"arguments\": {\n        \"listId\": \"3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\",\n        \"operationId\": \"c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\"\n      },\n      \"pollAfterSeconds\": 0\n    },\n    \"replay\": { \"reuseOperationId\": true, \"startNewWork\": false, \"debitAgain\": false },\n    \"stopReason\": \"max_credits\",\n    \"nextStep\": {\n      \"action\": \"raise_max_credits_and_resume\",\n      \"message\": \"Paused at the operation's maxCredits ceiling. Resume it with a maxCredits of at least 1001 to continue. Work already done is kept and is not charged again.\",\n      \"minimumMaxCredits\": 1001,\n      \"requiredCredits\": 3\n    },\n    \"errorMessage\": null,\n    \"startedAt\": \"2026-10-28T09:16:00.000Z\",\n    \"completedAt\": null,\n    \"createdAt\": \"2026-10-28T09:15:58.000Z\",\n    \"updatedAt\": \"2026-10-28T09:19:12.000Z\"\n  },\n  \"error\": null,\n  \"quotas\": {\n    \"creditsConsumed\": 0,\n    \"workspace\": {\n      \"id\": \"ws_abc123\",\n      \"credits\": { \"total\": 10000, \"used\": 5520, \"left\": 4480 }\n    }\n  },\n  \"metadata\": {\n    \"requestId\": \"60a16561-060b-4daa-9838-56deafe39c12\",\n    \"executionTimeMs\": 26\n  }\n}\n","200 - Paused at maxCredits","json",[478,1795,1791],{"__ignoreMap":1752},[1745,1797,1801],{"className":1798,"code":1799,"filename":1800,"language":1793,"meta":1752},[1790],"{\n  \"success\": true,\n  \"data\": {\n    \"operationId\": \"c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\",\n    \"listId\": \"3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\",\n    \"kind\": \"list_intake_persons\",\n    \"status\": \"completed\",\n    \"clientAction\": \"done\",\n    \"progress\": {\n      \"processed\": 2,\n      \"total\": 2,\n      \"succeeded\": 2,\n      \"failed\": 0,\n      \"skipped\": 0,\n      \"remaining\": 0,\n      \"unknownCount\": 0\n    },\n    \"creditsConsumed\": 4,\n    \"creditsPending\": 0,\n    \"creditsEstimated\": 0,\n    \"maxCredits\": 100,\n    \"estimatedSeconds\": 0,\n    \"estimateBlockedUntil\": null,\n    \"pollAfterSeconds\": 0,\n    \"pollUrl\": \"\u002Fv2\u002Flists\u002F3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\u002Foperations\u002Fc4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\u002Fprogress\",\n    \"followUp\": {\n      \"tool\": \"get_list_operation\",\n      \"arguments\": {\n        \"listId\": \"3f6c2a8e-1b4d-4f0a-9c7e-5d2b8a1e6f40\",\n        \"operationId\": \"c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f\"\n      },\n      \"pollAfterSeconds\": 0\n    },\n    \"replay\": { \"reuseOperationId\": true, \"startNewWork\": false, \"debitAgain\": false },\n    \"stopReason\": null,\n    \"nextStep\": null,\n    \"errorMessage\": null,\n    \"startedAt\": \"2026-10-28T09:16:00.000Z\",\n    \"completedAt\": \"2026-10-28T09:21:38.000Z\",\n    \"createdAt\": \"2026-10-28T09:15:58.000Z\",\n    \"updatedAt\": \"2026-10-28T09:21:38.000Z\",\n    \"rows\": {\n      \"items\": [\n        {\n          \"index\": 0,\n          \"rowNumber\": 1,\n          \"outcome\": \"added\",\n          \"externalId\": \"crm-001\",\n          \"memberId\": \"9b1e4c7a-2d3f-4e8a-b6c5-0a1f2e3d4c5b\",\n          \"errorCode\": null,\n          \"reason\": \"completed\",\n          \"signal\": { \"linkedinUrl\": \"https:\u002F\u002Fwww.social.com\u002Fin\u002Fjanedoe\" }\n        },\n        {\n          \"index\": 1,\n          \"rowNumber\": 2,\n          \"outcome\": \"already_present\",\n          \"externalId\": \"crm-002\",\n          \"memberId\": \"1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n          \"errorCode\": null,\n          \"reason\": \"completed\",\n          \"signal\": { \"email\": \"john.smith@acme.com\" }\n        }\n      ],\n      \"nextCursor\": null\n    }\n  },\n  \"error\": null,\n  \"quotas\": {\n    \"creditsConsumed\": 0,\n    \"workspace\": {\n      \"id\": \"ws_abc123\",\n      \"credits\": { \"total\": 10000, \"used\": 4526, \"left\": 5474 }\n    }\n  },\n  \"metadata\": {\n    \"requestId\": \"2d6a1a35-188a-4d9a-868f-2257ee4554c1\",\n    \"executionTimeMs\": 31\n  }\n}\n","200 - Completed, with rows",[478,1802,1799],{"__ignoreMap":1752},{"title":1752,"searchDepth":1804,"depth":1804,"links":1805},3,[1806,1807,1808,1813,1814,1815],{"id":19,"depth":298,"text":467},{"id":507,"depth":298,"text":508},{"id":557,"depth":298,"text":558,"children":1809},[1810,1811,1812],{"id":569,"depth":1804,"text":570},{"id":620,"depth":1804,"text":621},{"id":724,"depth":1804,"text":725},{"id":826,"depth":298,"text":827},{"id":1738,"depth":298,"text":1739},{"id":1775,"depth":298,"text":1776},"Follow an import with long polling, read why it paused and what to do, and page through its per-line results, for free.","md","2026-11-04",{},true,"\u002Fdocs\u002Fguides\u002Flists,\u002Fdocs\u002Fendpoints\u002Flist-intake-signals,\u002Fdocs\u002Fendpoints\u002Flist-operation-cancel",{"title":166,"description":1816},"endpoints\u002Flist-operation","ES_7Jb3ZaSbp7hyjAByjniWsa6FR7CusqFXx3COiBlE",1793830202178]