[{"data":1,"prerenderedAt":1447},["ShallowReactive",2],{"docs-navigation":3,"docs-\u002Fendpoints\u002Ftask":459},[4,12,16,21,27,34,41,47,54,59,65,71,76,81,86,91,96,102,107,112,117,123,129,134,139,144,149,154,161,167,172,177,183,188,193,198,202,207,212,217,222,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":100,"subfamily":100,"status":11,"endpointId":101,"badgeLabel":10},"\u002Fendpoints\u002Flist","Get a List",642,"Lists","list",{"path":103,"title":104,"category":30,"order":105,"family":100,"subfamily":100,"status":11,"endpointId":106,"badgeLabel":10},"\u002Fendpoints\u002Flist-create","Create a List",641,"list-create",{"path":108,"title":109,"category":30,"order":110,"family":100,"subfamily":100,"status":11,"endpointId":111,"badgeLabel":10},"\u002Fendpoints\u002Flist-delete","Delete a List",643,"list-delete",{"path":113,"title":114,"category":30,"order":115,"family":100,"subfamily":100,"status":11,"endpointId":116,"badgeLabel":10},"\u002Fendpoints\u002Flist-export","Export a List",644,"list-export",{"path":118,"title":119,"category":30,"order":120,"family":100,"subfamily":121,"status":11,"endpointId":122,"badgeLabel":10},"\u002Fendpoints\u002Flist-intake-signals","Import members and data",648,"Imports","list-intake-signals",{"path":124,"title":125,"category":30,"order":126,"family":100,"subfamily":127,"status":11,"endpointId":128,"badgeLabel":10},"\u002Fendpoints\u002Flist-members","List members",645,"Members","list-members",{"path":130,"title":131,"category":30,"order":132,"family":100,"subfamily":127,"status":11,"endpointId":133,"badgeLabel":10},"\u002Fendpoints\u002Flist-members-add","Add members",646,"list-members-add",{"path":135,"title":136,"category":30,"order":137,"family":100,"subfamily":127,"status":11,"endpointId":138,"badgeLabel":10},"\u002Fendpoints\u002Flist-members-remove","Remove members",647,"list-members-remove",{"path":140,"title":141,"category":30,"order":142,"family":100,"subfamily":121,"status":11,"endpointId":143,"badgeLabel":10},"\u002Fendpoints\u002Flist-operation","Read a List operation",649,"list-operation",{"path":145,"title":146,"category":30,"order":147,"family":100,"subfamily":121,"status":11,"endpointId":148,"badgeLabel":10},"\u002Fendpoints\u002Flist-operation-cancel","Cancel a List operation",650,"list-operation-cancel",{"path":150,"title":151,"category":30,"order":152,"family":100,"subfamily":100,"status":11,"endpointId":153,"badgeLabel":10},"\u002Fendpoints\u002Flists","All Lists",640,"lists",{"path":155,"title":156,"category":30,"order":157,"family":158,"subfamily":159,"status":11,"endpointId":160,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-companies","Company search",94,"Search","Companies","search-organizations",{"path":162,"title":163,"category":30,"order":164,"family":165,"subfamily":10,"status":11,"endpointId":166,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-companies-available-fields","Company search available fields",720,"Utility","search-organizations-available-fields",{"path":168,"title":169,"category":30,"order":170,"family":158,"subfamily":159,"status":11,"endpointId":171,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-companies-count","Company search count",95,"search-organizations-count",{"path":173,"title":174,"category":30,"order":175,"family":158,"subfamily":159,"status":11,"endpointId":176,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-companies-prompt","Agentic Company Search",97,"search-organizations-prompt",{"path":178,"title":179,"category":30,"order":180,"family":158,"subfamily":181,"status":11,"endpointId":182,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people","People search",92,"People","search-people",{"path":184,"title":185,"category":30,"order":186,"family":165,"subfamily":10,"status":11,"endpointId":187,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-auto-suggestion","People auto-suggestion",730,"search-people-auto-suggestion",{"path":189,"title":190,"category":30,"order":191,"family":165,"subfamily":10,"status":11,"endpointId":192,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-available-fields","People search available fields",710,"search-people-available-fields",{"path":194,"title":195,"category":30,"order":196,"family":158,"subfamily":181,"status":11,"endpointId":197,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-count","People search count",93,"search-people-count",{"path":199,"title":200,"category":30,"order":170,"family":158,"subfamily":181,"status":11,"endpointId":201,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-lookalike","People lookalike","search-people-lookalike",{"path":203,"title":204,"category":30,"order":205,"family":158,"subfamily":181,"status":11,"endpointId":206,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-prompt","Agentic Search",96,"search-people-prompt",{"path":208,"title":209,"category":30,"order":210,"family":32,"subfamily":10,"status":11,"endpointId":211,"badgeLabel":10},"\u002Fendpoints\u002Ftask","Get a task",662,"task",{"path":213,"title":214,"category":30,"order":215,"family":32,"subfamily":10,"status":11,"endpointId":216,"badgeLabel":10},"\u002Fendpoints\u002Ftask-cancel","Cancel a task",664,"task-cancel",{"path":218,"title":219,"category":30,"order":220,"family":32,"subfamily":10,"status":11,"endpointId":221,"badgeLabel":10},"\u002Fendpoints\u002Ftask-results","Download task results",663,"task-results",{"path":223,"title":224,"category":30,"order":225,"family":32,"subfamily":10,"status":11,"endpointId":226,"badgeLabel":10},"\u002Fendpoints\u002Ftask-rows","Read task results by page",663.5,"task-rows",{"path":228,"title":229,"category":30,"order":230,"family":32,"subfamily":10,"status":11,"endpointId":231,"badgeLabel":10},"\u002Fendpoints\u002Ftasks","Task history",661,"tasks",{"path":233,"title":234,"category":30,"order":235,"family":165,"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-tasks","Async tasks","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":329,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Flists","client.lists",{"path":372,"title":373,"category":333,"order":24,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Flists-and-bulk","Lists and Bulk enrichment",{"path":375,"title":376,"category":333,"order":20,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fsearch","client.search",{"path":378,"title":379,"category":333,"order":20,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fsearch-budget","Search within a budget",{"path":381,"title":382,"category":333,"order":346,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Ftasks","client.tasks",{"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-tasks",{"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":329,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Flists",{"path":422,"title":373,"category":333,"order":20,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Flists-and-bulk",{"path":424,"title":376,"category":333,"order":20,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fsearch",{"path":426,"title":379,"category":333,"order":8,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fsearch-budget",{"path":428,"title":382,"category":333,"order":346,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Ftasks",{"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":209,"audience":10,"badgeColor":10,"badgeLabel":10,"body":461,"category":30,"description":1438,"endpointId":211,"extension":1439,"family":32,"lastVerified":1440,"links":10,"meta":1441,"navigation":1442,"order":210,"path":208,"relatedArticles":1443,"requiresFlag":10,"seo":1444,"status":11,"stem":1445,"subfamily":10,"__hash__":1446},"docs\u002Fendpoints\u002Ftask.md",{"type":462,"value":463,"toc":1424},"minimark",[464,468,486,501,505,551,555,562,567,601,605,637,641,664,754,770,774,823,1297,1309,1313,1364,1368,1401,1405],[465,466,467],"h2",{"id":19},"Introduction",[469,470,471,472,476,477,481,482,485],"p",{},"The Get a task endpoint reads one task: it is the ",[473,474,475],"code",{},"links.self"," path of a task you ",[478,479,480],"a",{"href":28},"created",". It says how far the task is, what it reserved and spent, and, once it is completed or cancelled, where to download its results. It reads any task of the ",[478,483,484],{"href":228},"task history"," too, such as a List import or a Search export started in the app.",[469,487,488,489,493,494,496,497,500],{},"Reading a task is ",[490,491,492],"strong",{},"free",", also at a zero balance, and never counted against your rate limits, so you can follow a long task at the pace it asks for. A key reads the tasks its permissions allow: Person Enrichment or Contact for a ",[478,495,29],{"href":28}," task, Lists for a List task, Search for a Search export. A task the key may not read returns ",[473,498,499],{},"404",", as a task that does not exist.",[465,502,504],{"id":503},"authorization","Authorization",[506,507,508,527],"table",{},[509,510,511],"thead",{},[512,513,514,518,521,524],"tr",{},[515,516,517],"th",{},"Name",[515,519,520],{},"Type",[515,522,523],{},"Required",[515,525,526],{},"Description",[528,529,530],"tbody",{},[512,531,532,538,541,544],{},[533,534,535],"td",{},[473,536,537],{},"apikey",[533,539,540],{},"string",[533,542,543],{},"Yes",[533,545,546,547,550],{},"Your API key from the developer dashboard. Pass it via ",[473,548,549],{},"Authorization: Bearer YOUR_API_KEY"," header.",[465,552,554],{"id":553},"request","Request",[469,556,557,558,561],{},"The route is ",[473,559,560],{},"GET \u002Fv2\u002Ftasks\u002F:taskId",".",[563,564,566],"h3",{"id":565},"path-parameters","Path parameters",[506,568,569,581],{},[509,570,571],{},[512,572,573,575,577,579],{},[515,574,517],{},[515,576,520],{},[515,578,523],{},[515,580,526],{},[528,582,583],{},[512,584,585,590,592,594],{},[533,586,587],{},[473,588,589],{},"taskId",[533,591,540],{},[533,593,543],{},[533,595,596,597,600],{},"The ",[473,598,599],{},"id"," of the task (UUID)",[563,602,604],{"id":603},"query-parameters","Query Parameters",[506,606,607,619],{},[509,608,609],{},[512,610,611,613,615,617],{},[515,612,517],{},[515,614,520],{},[515,616,523],{},[515,618,526],{},[528,620,621],{},[512,622,623,628,631,634],{},[533,624,625],{},[473,626,627],{},"wait",[533,629,630],{},"integer",[533,632,633],{},"No",[533,635,636],{},"Hold the request up to this many seconds, 0 to 20, while the task is queued or running. It answers as soon as the task settles or pauses, or with the task still running when the wait ends. Defaults to 0.",[563,638,640],{"id":639},"how-to-follow-a-task","How to follow a task",[469,642,643,644,647,648,651,652,655,656,659,660,663],{},"Read the task while its ",[473,645,646],{},"status"," is ",[473,649,650],{},"queued"," or ",[473,653,654],{},"running",", with ",[473,657,658],{},"wait=20"," and an HTTP client timeout above it, for example 30 seconds. While the task moves, the response carries a ",[473,661,662],{},"Retry-After: 2"," header: start two reads at least that far apart. A held read already lasts longer, so the next one starts right away.",[506,665,666,677],{},[509,667,668],{},[512,669,670,674],{},[515,671,672],{},[473,673,646],{},[515,675,676],{},"What it means",[528,678,679,688,697,711,724,740],{},[512,680,681,685],{},[533,682,683],{},[473,684,650],{},[533,686,687],{},"Waiting for its turn: read it again",[512,689,690,694],{},[533,691,692],{},[473,693,654],{},[533,695,696],{},"Items are being looked up: read it again",[512,698,699,704],{},[533,700,701],{},[473,702,703],{},"paused",[533,705,706,707,710],{},"It waits to be resumed: a member of your workspace paused it in the app, or a List import reached its ",[473,708,709],{},"maxCredits"," or your balance",[512,712,713,718],{},[533,714,715],{},[473,716,717],{},"completed",[533,719,720,721],{},"Every item was handled: download the results at ",[473,722,723],{},"links.results",[512,725,726,731],{},[533,727,728],{},[473,729,730],{},"cancelled",[533,732,733,734,736,737,739],{},"Stopped: the items not started were never charged. The results of the items done are at ",[473,735,723],{},", where an item still in flight reads ",[473,738,654],{}," until it ends, within the hour",[512,741,742,747],{},[533,743,744],{},[473,745,746],{},"failed",[533,748,749,750,753],{},"The task could not run: ",[473,751,752],{},"error.code"," says why, and it has no results file",[469,755,756,758,759,761,762,764,765,769],{},[473,757,717],{},", ",[473,760,730],{}," and ",[473,763,746],{}," are final. The ",[478,766,768],{"href":767},"\u002Fendpoints\u002Fbulk-enrich-persons#webhook-callback","webhook"," of a task is sent when it reaches one of them.",[465,771,773],{"id":772},"response-structure","Response structure",[506,775,776,787],{},[509,777,778],{},[512,779,780,783,785],{},[515,781,782],{},"Field",[515,784,520],{},[515,786,526],{},[528,788,789,805],{},[512,790,791,796,799],{},[533,792,793],{},[473,794,795],{},"success",[533,797,798],{},"boolean",[533,800,801,804],{},[473,802,803],{},"true"," if the request was processed successfully",[512,806,807,812,817],{},[533,808,809],{},[473,810,811],{},"error",[533,813,814],{},[473,815,816],{},"null",[533,818,819,820,822],{},"Always ",[473,821,816],{}," on success",[824,825,828,834],"docs-object",{"field":826,"type":827},"data","Task",[829,830,831],"docs-object-description",{},[469,832,833],{},"The task",[835,836,837,1067,1164,1222],"docs-object-children",{},[506,838,839,849],{},[509,840,841],{},[512,842,843,845,847],{},[515,844,782],{},[515,846,520],{},[515,848,526],{},[528,850,851,862,894,911,933,963,977,992,1008,1025,1037,1052],{},[512,852,853,857,859],{},[533,854,855],{},[473,856,599],{},[533,858,540],{},[533,860,861],{},"Task id (UUID)",[512,863,864,869,871],{},[533,865,866],{},[473,867,868],{},"type",[533,870,540],{},[533,872,873,876,877,758,880,758,883,651,886,889,890],{},[473,874,875],{},"enrich_persons"," (Bulk enrichment, or a file enriched in the app), ",[473,878,879],{},"list_import",[473,881,882],{},"list_enrich",[473,884,885],{},"list_search_import",[473,887,888],{},"search_export",", see ",[478,891,893],{"href":892},"\u002Fendpoints\u002Ftasks#task-types","the task history",[512,895,896,901,903],{},[533,897,898],{},[473,899,900],{},"entity",[533,902,540],{},[533,904,905,651,908],{},[473,906,907],{},"persons",[473,909,910],{},"companies",[512,912,913,917,919],{},[533,914,915],{},[473,916,646],{},[533,918,540],{},[533,920,921,758,923,758,925,758,927,758,929,651,931],{},[473,922,650],{},[473,924,654],{},[473,926,703],{},[473,928,717],{},[473,930,730],{},[473,932,746],{},[512,934,935,940,943],{},[533,936,937],{},[473,938,939],{},"source",[533,941,942],{},"string | null",[533,944,945,946,949,950,952,953,651,956,959,960,962],{},"Who started it: ",[473,947,948],{},"api"," (an API key), ",[473,951,7],{}," (an AI assistant), ",[473,954,955],{},"ask",[473,957,958],{},"dashboard"," (a person in the app). ",[473,961,816],{}," for a task older than this field.",[512,964,965,970,972],{},[533,966,967],{},[473,968,969],{},"taskName",[533,971,540],{},[533,973,596,974,976],{},[473,975,969],{}," given at creation, or the file name of a task started in the app",[512,978,979,984,986],{},[533,980,981],{},[473,982,983],{},"listId",[533,985,942],{},[533,987,988,989,991],{},"The List a List task works on, ",[473,990,816],{}," otherwise",[512,993,994,999,1002],{},[533,995,996],{},[473,997,998],{},"estimatedSecondsRemaining",[533,1000,1001],{},"number | null",[533,1003,1004,1005,1007],{},"Seconds left at the recent pace while the task runs, ",[473,1006,816],{}," when unknown or settled",[512,1009,1010,1014,1017],{},[533,1011,1012],{},[473,1013,811],{},[533,1015,1016],{},"object | null",[533,1018,1019,1022,1023,991],{},[473,1020,1021],{},"{ \"code\": \"...\" }"," when the task failed, ",[473,1024,816],{},[512,1026,1027,1032,1034],{},[533,1028,1029],{},[473,1030,1031],{},"createdAt",[533,1033,540],{},[533,1035,1036],{},"Creation date (ISO 8601)",[512,1038,1039,1044,1046],{},[533,1040,1041],{},[473,1042,1043],{},"startedAt",[533,1045,942],{},[533,1047,1048,1049,1051],{},"When it started running, ",[473,1050,816],{}," while queued",[512,1053,1054,1059,1061],{},[533,1055,1056],{},[473,1057,1058],{},"completedAt",[533,1060,942],{},[533,1062,1063,1064,1066],{},"When it settled, ",[473,1065,816],{}," while it moves",[824,1068,1071,1076],{"field":1069,"type":1070},"progress","TaskProgress",[829,1072,1073],{},[469,1074,1075],{},"How far the task is",[835,1077,1078],{},[506,1079,1080,1090],{},[509,1081,1082],{},[512,1083,1084,1086,1088],{},[515,1085,782],{},[515,1087,520],{},[515,1089,526],{},[528,1091,1092,1105,1117,1129,1140,1152],{},[512,1093,1094,1099,1102],{},[533,1095,1096],{},[473,1097,1098],{},"total",[533,1100,1101],{},"number",[533,1103,1104],{},"Items in the task, duplicates included",[512,1106,1107,1112,1114],{},[533,1108,1109],{},[473,1110,1111],{},"processed",[533,1113,1101],{},[533,1115,1116],{},"Items done",[512,1118,1119,1124,1126],{},[533,1120,1121],{},[473,1122,1123],{},"succeeded",[533,1125,1101],{},[533,1127,1128],{},"Items that found at least part of what was asked",[512,1130,1131,1135,1137],{},[533,1132,1133],{},[473,1134,746],{},[533,1136,1101],{},[533,1138,1139],{},"Items that found nothing, or could not be looked up",[512,1141,1142,1147,1149],{},[533,1143,1144],{},[473,1145,1146],{},"skipped",[533,1148,1101],{},[533,1150,1151],{},"Items not run: a duplicate, no usable field, an invalid profile URL, not enough credits, or cancelled",[512,1153,1154,1159,1161],{},[533,1155,1156],{},[473,1157,1158],{},"remaining",[533,1160,1101],{},[533,1162,1163],{},"Items left to do",[824,1165,1168,1173],{"field":1166,"type":1167},"credits","TaskCredits",[829,1169,1170],{},[469,1171,1172],{},"What the task reserved and spent",[835,1174,1175],{},[506,1176,1177,1187],{},[509,1178,1179],{},[512,1180,1181,1183,1185],{},[515,1182,782],{},[515,1184,520],{},[515,1186,526],{},[528,1188,1189,1205],{},[512,1190,1191,1196,1198],{},[533,1192,1193],{},[473,1194,1195],{},"estimated",[533,1197,1101],{},[533,1199,1200,1201,1204],{},"Credits reserved when the task was created, ",[473,1202,1203],{},"0"," for a task that reserves nothing up front, such as a List import",[512,1206,1207,1212,1214],{},[533,1208,1209],{},[473,1210,1211],{},"used",[533,1213,1001],{},[533,1215,1216,1217,1219,1220,561],{},"Credits spent. A List import counts them as it goes; any other task reads ",[473,1218,816],{}," until it has settled them, then gives back the rest of ",[473,1221,1195],{},[824,1223,1226,1231],{"field":1224,"type":1225},"links","TaskLinks",[829,1227,1228],{},[469,1229,1230],{},"Where to go next",[835,1232,1233],{},[506,1234,1235,1245],{},[509,1236,1237],{},[512,1238,1239,1241,1243],{},[515,1240,782],{},[515,1242,520],{},[515,1244,526],{},[528,1246,1247,1259,1279],{},[512,1248,1249,1254,1256],{},[533,1250,1251],{},[473,1252,1253],{},"self",[533,1255,540],{},[533,1257,1258],{},"Path that reads this task",[512,1260,1261,1266,1268],{},[533,1262,1263],{},[473,1264,1265],{},"results",[533,1267,942],{},[533,1269,1270,1271,1273,1274,1276,1277,561],{},"Path of the results file, CSV or NDJSON, set once an ",[473,1272,875],{}," task is completed or cancelled. See ",[478,1275,219],{"href":218},". To read the results while the task runs, see ",[478,1278,224],{"href":223},[512,1280,1281,1286,1288],{},[533,1282,1283],{},[473,1284,1285],{},"operation",[533,1287,942],{},[533,1289,596,1290,1293,1294,1296],{},[478,1291,1292],{"href":140},"List operation"," a List task runs as, ",[473,1295,816],{}," for other tasks",[469,1298,1299,761,1302,1305,1306,561],{},[473,1300,1301],{},"quotas",[473,1303,1304],{},"metadata"," are the blocks of every V2 response: see ",[478,1307,234],{"href":1308},"\u002Fendpoints\u002Fusage#response-structure",[465,1310,1312],{"id":1311},"errors","Errors",[506,1314,1315,1328],{},[509,1316,1317],{},[512,1318,1319,1322,1325],{},[515,1320,1321],{},"Status",[515,1323,1324],{},"Code",[515,1326,1327],{},"Meaning",[528,1329,1330,1344],{},[512,1331,1332,1336,1341],{},[533,1333,1334],{},[473,1335,499],{},[533,1337,1338],{},[473,1339,1340],{},"TASK_NOT_FOUND",[533,1342,1343],{},"No task with this id in your workspace, or one your key may not read",[512,1345,1346,1351,1356],{},[533,1347,1348],{},[473,1349,1350],{},"422",[533,1352,1353],{},[473,1354,1355],{},"VALIDATION_ERROR",[533,1357,1358,1360,1361,1363],{},[473,1359,589],{}," is not a UUID, or ",[473,1362,627],{}," is not an integer from 0 to 20",[465,1365,1367],{"id":1366},"code-examples","Code examples",[1369,1370,1372,1383,1392],"code-group",{"title":1371},"Code Examples",[1373,1374,1381],"pre",{"className":1375,"code":1377,"filename":1378,"language":1379,"meta":1380},[1376],"language-bash","curl \"https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Ftasks\u002F7b1e4c2a-5d3f-4e8b-9a6c-1f2d3e4b5a60?wait=20\" \\\n  -H \"Authorization: Bearer YOUR_API_KEY\"\n","cURL","bash","",[473,1382,1377],{"__ignoreMap":1380},[1373,1384,1390],{"className":1385,"code":1387,"filename":1388,"language":1389,"meta":1380},[1386],"language-javascript","const taskId = \"7b1e4c2a-5d3f-4e8b-9a6c-1f2d3e4b5a60\";\nconst headers = { \"Authorization\": \"Bearer YOUR_API_KEY\" };\n\nlet task;\ndo {\n  const response = await fetch(`https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Ftasks\u002F${taskId}?wait=20`, { headers });\n  task = (await response.json()).data;\n} while (task.status === \"queued\" || task.status === \"running\");\n\nconsole.log(task.status, `${task.credits.used} of ${task.credits.estimated} credits`, task.links.results);\n","JavaScript","javascript",[473,1391,1387],{"__ignoreMap":1380},[1373,1393,1399],{"className":1394,"code":1396,"filename":1397,"language":1398,"meta":1380},[1395],"language-python","import requests\n\ntask_id = \"7b1e4c2a-5d3f-4e8b-9a6c-1f2d3e4b5a60\"\nheaders = {\"Authorization\": \"Bearer YOUR_API_KEY\"}\n\nwhile True:\n    task = requests.get(\n        f\"https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Ftasks\u002F{task_id}\",\n        headers=headers,\n        params={\"wait\": 20},\n        timeout=30\n    ).json()[\"data\"]\n    if task[\"status\"] not in (\"queued\", \"running\"):\n        break\n\nprint(task[\"status\"], task[\"credits\"][\"used\"], task[\"links\"][\"results\"])\n","Python","python",[473,1400,1396],{"__ignoreMap":1380},[465,1402,1404],{"id":1403},"example-response","Example response",[1369,1406,1408,1417],{"title":1407},"Example Response",[1373,1409,1415],{"className":1410,"code":1412,"filename":1413,"language":1414,"meta":1380},[1411],"language-json","{\n  \"success\": true,\n  \"data\": {\n    \"id\": \"7b1e4c2a-5d3f-4e8b-9a6c-1f2d3e4b5a60\",\n    \"type\": \"enrich_persons\",\n    \"entity\": \"persons\",\n    \"status\": \"completed\",\n    \"source\": \"api\",\n    \"taskName\": \"CRM export, November\",\n    \"listId\": null,\n    \"progress\": {\n      \"total\": 2,\n      \"processed\": 2,\n      \"succeeded\": 2,\n      \"failed\": 0,\n      \"skipped\": 0,\n      \"remaining\": 0\n    },\n    \"credits\": { \"estimated\": 9, \"used\": 6 },\n    \"estimatedSecondsRemaining\": null,\n    \"error\": null,\n    \"createdAt\": \"2026-11-04T09:30:00.000Z\",\n    \"startedAt\": \"2026-11-04T09:30:01.000Z\",\n    \"completedAt\": \"2026-11-04T09:31:12.000Z\",\n    \"links\": {\n      \"self\": \"\u002Fv2\u002Ftasks\u002F7b1e4c2a-5d3f-4e8b-9a6c-1f2d3e4b5a60\",\n      \"results\": \"\u002Fv2\u002Ftasks\u002F7b1e4c2a-5d3f-4e8b-9a6c-1f2d3e4b5a60\u002Fresults\",\n      \"operation\": null\n    }\n  },\n  \"error\": null,\n  \"quotas\": {\n    \"creditsConsumed\": 0,\n    \"workspace\": {\n      \"id\": \"ws_abc123\",\n      \"credits\": { \"total\": 10000, \"used\": 4528, \"left\": 5472 }\n    }\n  },\n  \"metadata\": {\n    \"requestId\": \"e5e6c816-df62-43a7-8fbe-1d3a94b6909c\",\n    \"executionTimeMs\": 31\n  }\n}\n","200 - Completed","json",[473,1416,1412],{"__ignoreMap":1380},[1373,1418,1422],{"className":1419,"code":1420,"filename":1421,"language":1414,"meta":1380},[1411],"{\n  \"success\": false,\n  \"data\": null,\n  \"error\": {\n    \"code\": \"TASK_NOT_FOUND\",\n    \"message\": \"No task found with that identifier\"\n  },\n  \"quotas\": {\n    \"creditsConsumed\": 0,\n    \"workspace\": {\n      \"id\": \"ws_abc123\",\n      \"credits\": { \"total\": 10000, \"used\": 4528, \"left\": 5472 }\n    }\n  },\n  \"metadata\": {\n    \"requestId\": \"6408b12a-8668-464f-97f3-3a1497efb4f5\",\n    \"executionTimeMs\": 12\n  }\n}\n","404 - Not found",[473,1423,1420],{"__ignoreMap":1380},{"title":1380,"searchDepth":1425,"depth":1425,"links":1426},3,[1427,1428,1429,1434,1435,1436,1437],{"id":19,"depth":298,"text":467},{"id":503,"depth":298,"text":504},{"id":553,"depth":298,"text":554,"children":1430},[1431,1432,1433],{"id":565,"depth":1425,"text":566},{"id":603,"depth":1425,"text":604},{"id":639,"depth":1425,"text":640},{"id":772,"depth":298,"text":773},{"id":1311,"depth":298,"text":1312},{"id":1366,"depth":298,"text":1367},{"id":1403,"depth":298,"text":1404},"Follow a task with long polling until it settles, with its progress, the credits it reserved and spent, and the link to its results, for free.","md","2026-11-04",{},true,"\u002Fdocs\u002Fendpoints\u002Fbulk-enrich-persons,\u002Fdocs\u002Fendpoints\u002Ftask-results,\u002Fdocs\u002Fendpoints\u002Ftask-cancel",{"title":209,"description":1438},"endpoints\u002Ftask","IUB5boxgzqi5_p_5lhQ2umEfQn17OpONc5Bsb10yy1k",1793892637361]