[{"data":1,"prerenderedAt":593},["ShallowReactive",2],{"docs-navigation":3,"docs-\u002Fguides\u002Fcredits":226},[4,11,16,21,29,35,42,48,54,59,64,69,74,79,86,92,97,102,108,113,118,122,127,132,136,141,146,150,154,158,161,165,170,174,177,180,184,188,192,196,199,203,207,211,215,219,223],{"path":5,"title":6,"category":7,"order":8,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fagents","Agent brief","mcp",40,null,"new",{"path":12,"title":13,"category":14,"order":15,"family":9,"subfamily":9,"status":9,"endpointId":9},"\u002Fapi-reference","API reference","introduction",30,{"path":17,"title":18,"category":14,"order":19,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fauthentication","Authentication",20,"updated",{"path":22,"title":23,"category":24,"order":25,"family":26,"subfamily":27,"status":20,"endpointId":28},"\u002Fendpoints\u002Fcheck-company","Company profile status","endpoints",220,"Fetch","Company","check-company",{"path":30,"title":31,"category":24,"order":32,"family":26,"subfamily":33,"status":20,"endpointId":34},"\u002Fendpoints\u002Fcheck-person","Person profile status",120,"Person","check-person",{"path":36,"title":37,"category":24,"order":38,"family":39,"subfamily":40,"status":9,"endpointId":41},"\u002Fendpoints\u002Fcontact-email","Find Email",600,"Contact","Email","contact-email",{"path":43,"title":44,"category":24,"order":45,"family":39,"subfamily":46,"status":9,"endpointId":47},"\u002Fendpoints\u002Fcontact-phone","Find Phone",610,"Phone","contact-phone",{"path":49,"title":50,"category":24,"order":51,"family":52,"subfamily":27,"status":20,"endpointId":53},"\u002Fendpoints\u002Fenrich-company","Enrich company",90,"Enrichment","enrich-company",{"path":55,"title":56,"category":24,"order":57,"family":52,"subfamily":33,"status":20,"endpointId":58},"\u002Fendpoints\u002Fenrich-person","Enrich profile",80,"enrich-person",{"path":60,"title":61,"category":24,"order":62,"family":26,"subfamily":27,"status":20,"endpointId":63},"\u002Fendpoints\u002Ffetch-company","Company profile",200,"fetch-company",{"path":65,"title":66,"category":24,"order":67,"family":26,"subfamily":27,"status":20,"endpointId":68},"\u002Fendpoints\u002Ffetch-company-live","Company profile live",210,"fetch-company-live",{"path":70,"title":71,"category":24,"order":72,"family":26,"subfamily":33,"status":20,"endpointId":73},"\u002Fendpoints\u002Ffetch-profile","Person profile",100,"fetch-profile",{"path":75,"title":76,"category":24,"order":77,"family":26,"subfamily":33,"status":20,"endpointId":78},"\u002Fendpoints\u002Ffetch-profile-live","Person profile live",110,"fetch-profile-live",{"path":80,"title":81,"category":24,"order":82,"family":83,"subfamily":84,"status":10,"endpointId":85},"\u002Fendpoints\u002Fsearch-companies","Company search",94,"Search","Companies","search-organizations",{"path":87,"title":88,"category":24,"order":89,"family":90,"subfamily":9,"status":10,"endpointId":91},"\u002Fendpoints\u002Fsearch-companies-available-fields","Company search available fields",720,"Utility","search-organizations-available-fields",{"path":93,"title":94,"category":24,"order":95,"family":83,"subfamily":84,"status":10,"endpointId":96},"\u002Fendpoints\u002Fsearch-companies-count","Company search count",95,"search-organizations-count",{"path":98,"title":99,"category":24,"order":100,"family":83,"subfamily":84,"status":10,"endpointId":101},"\u002Fendpoints\u002Fsearch-companies-prompt","Agentic Company Search",97,"search-organizations-prompt",{"path":103,"title":104,"category":24,"order":105,"family":83,"subfamily":106,"status":10,"endpointId":107},"\u002Fendpoints\u002Fsearch-people","People search",92,"People","search-people",{"path":109,"title":110,"category":24,"order":111,"family":90,"subfamily":9,"status":10,"endpointId":112},"\u002Fendpoints\u002Fsearch-people-available-fields","People search available fields",710,"search-people-available-fields",{"path":114,"title":115,"category":24,"order":116,"family":83,"subfamily":106,"status":10,"endpointId":117},"\u002Fendpoints\u002Fsearch-people-count","People search count",93,"search-people-count",{"path":119,"title":120,"category":24,"order":95,"family":83,"subfamily":106,"status":10,"endpointId":121},"\u002Fendpoints\u002Fsearch-people-lookalike","People lookalike","search-people-lookalike",{"path":123,"title":124,"category":24,"order":125,"family":83,"subfamily":106,"status":10,"endpointId":126},"\u002Fendpoints\u002Fsearch-people-prompt","Agentic Search",96,"search-people-prompt",{"path":128,"title":129,"category":24,"order":130,"family":90,"subfamily":9,"status":20,"endpointId":131},"\u002Fendpoints\u002Fusage","Usage",700,"usage",{"path":133,"title":134,"category":14,"order":135,"family":9,"subfamily":9,"status":9,"endpointId":9},"\u002Fgetting-started","Getting started",10,{"path":137,"title":138,"category":139,"order":140,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fagent-skills","Agent skills","cli",70,{"path":142,"title":143,"category":144,"order":145,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fapi-key-management","API key management","guides",12,{"path":147,"title":148,"category":139,"order":149,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fcli","Command line interface (CLI)",60,{"path":151,"title":152,"category":144,"order":153,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fcredits","Credits",24,{"path":155,"title":156,"category":144,"order":157,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fcurrent-position-resolution","Current position and work history ordering",35,{"path":159,"title":160,"category":144,"order":8,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fdata-freshness","Data freshness",{"path":162,"title":163,"category":144,"order":164,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fdata-quality","Data quality",18,{"path":166,"title":167,"category":168,"order":169,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fendpoint-transition-october-2026","Endpoint transition on October 13, 2026","migrations",1,{"path":171,"title":172,"category":144,"order":173,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fenrich-a-csv-file","Enrich a CSV file",16,{"path":175,"title":176,"category":144,"order":19,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Ferrors-retries","Error handling & retries",{"path":178,"title":179,"category":144,"order":135,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Ffirst-api-call","Your first API call",{"path":181,"title":182,"category":7,"order":183,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fmcp","Connect AI agents (MCP)",50,{"path":185,"title":186,"category":168,"order":187,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fmigrating-search-companies-to-organizations","Migrating company search to the new endpoint",2,{"path":189,"title":190,"category":168,"order":191,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fmigrating-search-persons-to-people","Migrating people search from persons to people",51,{"path":193,"title":194,"category":144,"order":195,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fmissing-and-empty-fields","Missing and empty profile fields",42,{"path":197,"title":198,"category":144,"order":15,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fpolling","Polling, zero setup",{"path":200,"title":201,"category":144,"order":202,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fproduction-checklist","Production checklist",45,{"path":204,"title":205,"category":144,"order":206,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Frate-limits","Rate limits",25,{"path":208,"title":209,"category":144,"order":210,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fwebhooks","Webhooks",31,{"path":212,"title":213,"category":144,"order":214,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fwhich-endpoint-should-i-use","Which endpoint should I use?",15,{"path":216,"title":217,"category":218,"order":183,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Freference\u002Findustries","Industry values","reference",{"path":220,"title":221,"category":222,"order":135,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fsdk\u002Fjavascript","JavaScript and TypeScript","sdk",{"path":224,"title":225,"category":222,"order":19,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fsdk\u002Fpython","Python",{"id":227,"title":152,"audience":9,"badgeColor":9,"badgeLabel":9,"body":228,"category":144,"description":584,"endpointId":9,"extension":585,"family":9,"lastVerified":586,"links":9,"meta":587,"navigation":588,"order":153,"path":151,"relatedArticles":589,"requiresFlag":9,"seo":590,"status":20,"stem":591,"subfamily":9,"__hash__":592},"docs\u002Fguides\u002Fcredits.md",{"type":229,"value":230,"toc":569},"minimark",[231,244,249,274,277,321,325,337,363,400,404,415,419,422,458,468,472,481,504,508,513,522,526,529,533,553,557],[232,233,234,235,240,241,243],"p",{},"Most requests cost between 0 and 3 credits depending on the endpoint. Find Email costs 3 credits when a professional email is found and 5 when a personal one is found (8 when a lookup finds both), Find Phone costs 20 credits when a number is found, the people search endpoints cost 1 credit per profile delivered and Company search 1 credit per company delivered, plus 1 credit per page for Agentic Search and Agentic Company Search. Most errors and status checks are always free. The ",[236,237,239],"a",{"href":238},"\u002Fpricing","API pricing"," page lists every endpoint, and ",[236,242,205],{"href":204}," covers how many requests you can send.",[245,246,248],"h2",{"id":247},"youre-never-charged-for","You're never charged for",[250,251,252,268],"ul",{},[253,254,255,259,260,264,265,267],"li",{},[256,257,258],"strong",{},"Errors","\nall 4xx and 5xx responses cost 0 credits, except ",[261,262,263],"code",{},"404"," which depends on the endpoint (see ",[236,266,239],{"href":238},").",[253,269,270,273],{},[256,271,272],{},"Check and Usage endpoints","\nalways 0 credits, designed for testing and decision-making before spending.",[232,275,276],{},"You can test the API freely before committing credits.",[278,279,281],"docs-alert",{"type":280},"important",[232,282,283,286,287,290,291,294,295,298,299,302,303,306,307,310,311,314,315],{},[256,284,285],{},"When your workspace has fewer than 2 credits left, the free Check endpoints are paused too."," A call to ",[261,288,289],{},"POST \u002Fv2\u002Ffetch\u002Fpersons\u002Fcheck"," or ",[261,292,293],{},"\u002Fv2\u002Ffetch\u002Fcompanies\u002Fcheck"," then returns ",[261,296,297],{},"402 NO_CREDITS"," instead of a result, because the fetch that follows a check can cost 2 credits. Status and result endpoints stay open: ",[261,300,301],{},"GET \u002Fv2\u002Fusage",", ",[261,304,305],{},"GET \u002Fv2\u002Fflags",", the Search ",[261,308,309],{},"available-fields"," endpoints, and webhook polling (",[261,312,313],{},"GET \u002Fv2\u002Fwebhooks\u002F:webhookId",") keep working so you can still read your balance and retrieve already-paid results. ",[236,316,320],{"href":317,"rel":318},"https:\u002F\u002Fapp.reversecontact.com\u002Fsettings\u002Fbilling?tab=credits",[319],"nofollow","Top up →",[245,322,324],{"id":323},"per-endpoint-pricing","Per-endpoint pricing",[232,326,327,328,330,331,336],{},"The ",[236,329,239],{"href":238}," page lists every endpoint with what it costs when it finds a result and when it does not, whether an async lookup that finds nothing is refunded, and where its data comes from. Its figures are the ones the API bills, and the same table is in your dashboard under ",[236,332,335],{"href":333,"rel":334},"https:\u002F\u002Fapp.reversecontact.com\u002Fsettings\u002Fbilling\u002Fapi-pricing",[319],"Billing > API pricing",".",[232,338,339,340,343,344,302,347,302,350,302,353,356,357,362],{},"Async endpoints follow their own ",[256,341,342],{},"billing model",": credits are charged when the request creates the job, then refunded automatically based on the outcome. A job that ends in error without data (",[261,345,346],{},"fetch-data-error",[261,348,349],{},"invalid-data",[261,351,352],{},"result-unavailable",[261,354,355],{},"invalid-request",") is refunded, and so is a Find Email or Find Phone lookup that finds nothing. A live fetch that finds no profile is billed. Refunds are auditable in the ",[236,358,361],{"href":359,"rel":360},"https:\u002F\u002Fapp.reversecontact.com\u002Flogs\u002Fevents",[319],"Webhook Events"," dashboard.",[278,364,366],{"type":365},"note",[232,367,368,371,372,302,375,302,378,302,381,384,385,388,389,392,393,396,397,399],{},[256,369,370],{},"Webhook delivery failures are not refunded."," When your webhook URL is invalid, returns an error, times out, or is unreachable (",[261,373,374],{},"webhook-url-invalid",[261,376,377],{},"webhook-url-errored",[261,379,380],{},"webhook-url-timeout",[261,382,383],{},"webhook-url-unreachable","), the credit is kept because the data was successfully fetched. The job is reported as ",[261,386,387],{},"succeeded"," with a ",[261,390,391],{},"deliveryStatus"," field naming the delivery problem, and the ",[261,394,395],{},"result"," is populated, poll ",[261,398,313],{}," to retrieve it.",[245,401,403],{"id":402},"plans-and-credits","Plans and credits",[232,405,406,407,409,410,336],{},"Credits work on every endpoint. On a Go, Plus or Max plan, the calls your plan covers cost 0 credits, up to the daily profile cap described in ",[236,408,205],{"href":204},", and every other call costs credits. What each plan covers is on the ",[236,411,414],{"href":412,"rel":413},"https:\u002F\u002Fwww.reversecontact.com\u002Fpricing",[319],"pricing page",[245,416,418],{"id":417},"agent-mcp-and-dashboard-usage","Agent, MCP, and dashboard usage",[232,420,421],{},"Not every credit-consuming action shows up as the same kind of usage event:",[250,423,424,434,440,446],{},[253,425,426,429,430,433],{},[256,427,428],{},"Agent LLM turns"," consume credits, but they do ",[256,431,432],{},"not"," call the API endpoints.",[253,435,436,439],{},[256,437,438],{},"Agent tool calls"," use the same endpoints as the REST API and consume the same endpoint credits.",[253,441,442,445],{},[256,443,444],{},"MCP calls"," use the same credits as the REST API.",[253,447,448,451,452,454,455,457],{},[256,449,450],{},"Polling and status-only endpoints"," such as ",[261,453,301],{}," and ",[261,456,313],{}," stay free.",[232,459,460,461,464,465,336],{},"In the dashboard, the ",[256,462,463],{},"Usage channels"," section is the best view to understand where credits are going across Agent, MCP, and API usage. The request analytics tabs remain HTTP-request-centric on purpose. How each of these counts toward your per-minute limit is in ",[236,466,205],{"href":467},"\u002Fguides\u002Frate-limits#how-requests-are-counted",[245,469,471],{"id":470},"save-credits","Save credits",[232,473,474,477,478,480],{},[256,475,476],{},"Check before you fetch."," Call the free Check endpoint first to see if a profile exists and when it was last updated. Then decide: cached fetch (1 credit) or live scrape (2 credits). See ",[236,479,160],{"href":159}," for the full strategy.",[232,482,483,486,487,489,490,493,494,496,497,499,500,503],{},[256,484,485],{},"Use Search for bulk discovery."," ",[236,488,104],{"href":103}," returns full profiles and costs 1 credit per profile delivered, so size your query first with the free ",[236,491,492],{"href":114},"count endpoint",". ",[236,495,81],{"href":80}," works the same way for companies: full company profiles at 1 credit per company delivered, sized for free with its own ",[236,498,492],{"href":93},". On both, lower ",[261,501,502],{},"perPage"," to cap what a single request can spend.",[245,505,507],{"id":506},"faq","FAQ",[509,510,512],"h3",{"id":511},"am-i-charged-for-errors-or-404-responses","Am I charged for errors or 404 responses?",[232,514,515,516,518,519,521],{},"Reverse Contact API responses with a 4xx or 5xx status cost 0 credits, except ",[261,517,263],{},", whose cost depends on the endpoint. The Reverse Contact API pricing page gives the cost of a ",[261,520,263],{}," for every endpoint, in its Not found column.",[509,523,525],{"id":524},"where-can-i-see-what-each-reverse-contact-endpoint-costs","Where can I see what each Reverse Contact endpoint costs?",[232,527,528],{},"The Reverse Contact API pricing page, at docs.reversecontact.com\u002Fpricing, lists every endpoint with its cost when it finds a result, its cost when it does not, whether an async lookup that finds nothing is refunded, and where its data comes from. The same table is in the dashboard under Billing > API pricing.",[509,530,532],{"id":531},"can-i-still-call-the-api-when-my-credits-run-out","Can I still call the API when my credits run out?",[232,534,535,536,454,538,540,541,493,543,302,545,306,547,549,550,552],{},"When a Reverse Contact workspace has fewer than 2 credits left, even the free Check endpoints (",[261,537,289],{},[261,539,293],{},") return ",[261,542,297],{},[261,544,301],{},[261,546,305],{},[261,548,309],{}," endpoints and webhook polling (",[261,551,313],{},") keep working, so you can still read your balance and retrieve already-paid results.",[509,554,556],{"id":555},"are-credits-refunded-when-an-async-request-finds-nothing","Are credits refunded when an async request finds nothing?",[232,558,559,560,302,562,302,564,302,566,568],{},"It depends on the endpoint. Reverse Contact async requests are charged at creation. Find Email and Find Phone refund the credits automatically when no email or phone number is found, and a job that ends in error without data (",[261,561,346],{},[261,563,349],{},[261,565,352],{},[261,567,355],{},") is refunded. A live fetch that finds no profile is billed. Webhook delivery failures are not refunded, because the data was successfully fetched, and refunds can be audited in the Webhook Events dashboard.",{"title":570,"searchDepth":571,"depth":571,"links":572},"",3,[573,574,575,576,577,578],{"id":247,"depth":187,"text":248},{"id":323,"depth":187,"text":324},{"id":402,"depth":187,"text":403},{"id":417,"depth":187,"text":418},{"id":470,"depth":187,"text":471},{"id":506,"depth":187,"text":507,"children":579},[580,581,582,583],{"id":511,"depth":571,"text":512},{"id":524,"depth":571,"text":525},{"id":531,"depth":571,"text":532},{"id":555,"depth":571,"text":556},"How the API charges credits, what is always free, how async jobs are refunded, and how to spend less.","md","2026-10-15",{},true,"\u002Fdocs\u002Fguides\u002Frate-limits,\u002Fdocs\u002Fguides\u002Fproduction-checklist,\u002Fdocs\u002Fguides\u002Ferrors-retries,\u002Fdocs\u002Fguides\u002Fdata-freshness",{"title":152,"description":584},"guides\u002Fcredits","JaDlJ2IYurf26EcRI6HxICbLX3pyL_Fvbe55UUANigA",1793052756815]