{"uid":"cap_qgvAUvTWPDdUu1jkgKNOq","slug":"toll402-business-shortlist-e715133c","name":"Toll402 Business Shortlist","description":"Sourcing for agents whose principal is launching or buying something: describe the need (\"opening a coffee brand in Monterrey, need packaging suppliers and a designer\") and get a ranked shortlist of real businesses with a reason, fit score, best contact channel, staff size from official registries, verification level and website summary when curated. Covers each role in the need and says what is missing.","url":"https://toll402.dev/v1/biz/shortlist","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"city":{"type":"string","maxLength":80,"minLength":2},"need":{"type":"string","maxLength":600,"minLength":8,"description":"What you are trying to do and what kind of businesses you need"},"limit":{"type":"integer","default":6,"maximum":10,"minimum":3},"country":{"type":"string","maxLength":2,"minLength":2,"description":"ISO-3166 alpha-2, e.g. MX"},"minEmployees":{"type":"integer","maximum":251,"minimum":0},"requireWebsite":{"type":"boolean","default":false}}},"responseSchema":{"type":"json","example":{"city":"Guadalajara","gaps":null,"shortlist":[{"fit":82,"why":"Verified roaster with wholesale page","role":"coffee roaster","business":{"name":"…"},"bestContact":"email"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ceynj_FagUWvuE_LSQZc9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Given a natural-language description of a sourcing need and a city/country, returns a ranked shortlist of real local businesses with fit scores, contact channels, staff sizes, verification levels, and identified gaps.","exampleAgentPrompt":"I'm launching a cold-brew coffee brand in Guadalajara, Mexico — can you find me a shortlist of up to 8 local businesses I'd need, like packaging suppliers and graphic designers, preferably ones with websites?","exampleUseCases":[{"title":"Coffee brand launch supplier search","prompt":"I'm opening a specialty coffee brand in Monterrey, Mexico and need packaging suppliers, a label designer, and a local coffee roaster — can you find me a ranked shortlist of up to 8 real businesses for each of those roles?"},{"title":"E-commerce fulfillment sourcing in Buenos Aires","prompt":"I'm launching an e-commerce store in Buenos Aires, Argentina and need a 3PL warehouse, a packaging supplier, and a logistics courier — give me a shortlist of verified local companies, ideally ones with websites, no more than 6 results."},{"title":"Restaurant concept vendor sourcing","prompt":"I'm buying into a taqueria concept in Guadalajara and need to find local kitchen equipment suppliers, a food packaging company, and a commercial interior designer — can you pull a ranked shortlist of real businesses in Guadalajara, Mexico that cover those roles?"}],"resultDescription":"A JSON object containing a ranked shortlist of real businesses, each with a name, role, fit score (0-100), reason for the match, best contact channel (e.g. email, phone), staff size from official registries, and verification level. A 'gaps' field flags any roles in the stated need that could not be filled by found businesses.","failureModes":["No businesses found for the specified city or need — gaps field will flag missing roles","City or country not recognized or too sparsely indexed — returns empty shortlist","Need description too vague to parse into distinct roles — may return partial or mismatched results","minEmployees filter too restrictive — may reduce shortlist below requested limit","requireWebsite=true combined with small city may severely limit results"],"whenToPreferThis":"Use this endpoint when an agent's principal is in the early sourcing or vendor discovery phase of launching, buying, or building a business and needs a curated, ranked shortlist of real local businesses covering specific roles — rather than a raw directory search or a generic web search. Prefer this over general search when you need fit scoring, verification levels, staff size signals, and gap detection in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:53:36.713Z","isFirstParty":false}