{"uid":"cap_woKWNPpL_NIQj-2_352zk","slug":"rafid-procurement-vendor-shortlist-api-252313fc","name":"Rafid Procurement Vendor Shortlist API","description":"Rafid Agent API provides structured intelligence and paid APIs for AI agents across property, company and risk, supplier, finance, document, website, automotive, logistics, recruitment, trading, voice, video and business-planning workflows.","url":"https://api.rafidsystem.com/api/v1/x402/procurement/vendor-shortlist?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":2000000,"minLength":1},"suppliers":{"type":"array","items":{"type":"object","required":["companyName"],"properties":{"email":{"type":"string","pattern":"^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$","maxLength":254},"phone":{"type":"string","pattern":"^[+0-9\\s()\\-.xX*]+$","maxLength":30,"minLength":6},"address":{"type":"string","maxLength":300,"minLength":2},"website":{"type":"string","maxLength":300,"minLength":4},"crNumber":{"type":"string","pattern":"^[0-9A-Za-z][0-9A-Za-z\\s\\-/.]*$","maxLength":30,"minLength":3},"companyName":{"type":"string","maxLength":200,"minLength":2},"requiredProductOrService":{"type":"string","maxLength":200,"minLength":2}},"additionalProperties":false},"maxItems":100,"minItems":2},"maxResults":{"type":"integer","maximum":100,"minimum":1}}},"responseSchema":{"type":"json","example":{"result":{"vendors":[],"screenedCount":0},"workflow":"procurement_vendor_shortlist","limitations":["Ranking is decision support; procurement agents must review evidence, conflicts and unavailable checks before selecting a vendor."]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"2","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":"$2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9951miLEaeH_dsSWLqZ-R","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Screens and ranks a list of supplier candidates to produce a shortlist of the best-fit vendors for a procurement decision.","exampleAgentPrompt":"Screen these 10 suppliers for our IT equipment procurement — company names are TechSource LLC, AlphaSupply Co, and 8 others I'll attach as a CSV — and return the top 5 ranked by suitability, including their websites and CR numbers where I've provided them.","exampleUseCases":[{"title":"Shortlisting IT hardware suppliers","prompt":"I have a list of 15 IT hardware vendors we've worked with before. Screen them and give me the top 5 shortlisted candidates based on what we know about them — I'll send you their names, websites, and company registration numbers. We need them for laptop procurement."},{"title":"Qualifying new logistics partners","prompt":"We're onboarding logistics partners for our warehouse operations. Here are 20 candidates with their company names, emails, phone numbers, and addresses — screen them and shortlist the top 8 most suitable for providing warehousing and last-mile delivery services."},{"title":"Supplier rationalization from a CSV export","prompt":"I've exported our supplier database as a CSV — it has about 60 vendors in it. Run them through vendor screening and return the top 10 best-ranked suppliers for office consumables procurement, based on whatever intelligence you can pull on each one."}],"resultDescription":"A JSON object containing a ranked list of shortlisted vendors with screened intelligence, the total count of suppliers screened, and a workflow identifier. Each vendor entry reflects scoring and decision-support data. A limitations note reminds the agent to review evidence before final selection.","failureModes":["Fewer than 2 suppliers provided — minimum array length not met","companyName missing on one or more supplier objects — required field validation failure","CSV payload exceeds 2MB size limit","maxResults outside the 1–100 range","Invalid email or phone format on a supplier record","Insufficient data on suppliers for meaningful ranking — sparse results returned","Payment not completed — HTTP 402 returned before processing begins"],"whenToPreferThis":"Use this endpoint when an AI agent needs to programmatically narrow a list of 2–100 supplier candidates to a ranked shortlist for procurement decisions, especially when supplier metadata (CR number, website, contact details) is available to improve screening quality. Prefer this over generic web search or manual comparison when structured, repeatable vendor ranking is required as part of an automated procurement workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:39:54.663Z","isFirstParty":false,"canonicalSlug":"rafid-procurement-vendor-shortlist-api-252313fc"}