# Rafid Procurement Vendor Shortlist API

> Rafid Procurement Vendor Shortlist API is a paid API for AI agents from api.rafidsystem.com, paid per call via x402, $2/call, status unknown (last checked 2026-10-10).

Screens and ranks a list of supplier candidates to produce a shortlist of the best-fit vendors for a procurement decision.

## Facts

- Endpoint: POST https://api.rafidsystem.com/api/v1/x402/procurement/vendor-shortlist?utm_source=zero.xyz
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rafid-procurement-vendor-shortlist-api-252313fc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_woKWNPpL_NIQj-2_352zk

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability rafid-procurement-vendor-shortlist-api-252313fc -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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."
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rafid-procurement-vendor-shortlist-api-252313fc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.rafidsystem.com](https://www.zero.xyz/host/api.rafidsystem.com/llms.txt)