# Rafid Business Search API

> Rafid Business Search API is a paid API for AI agents from api.rafidsystem.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-11).

Searches for businesses and companies in Oman by name, industry, and location (governorate/wilayat), returning structured company intelligence with confidence scores.

## Facts

- Endpoint: POST https://api.rafidsystem.com/api/v1/x402/business/search?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rafid-business-search-api-69d575da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H0Wk1b2EnwEhB8sAlOTqt

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-business-search-api-69d575da -d '<json body>'
```

Example prompt: Can you search for active trading companies in the Muscat governorate, Muttrah wilayat, and give me up to 10 results?

## When to prefer this

Use this endpoint when you need to search for and verify businesses registered in Oman by name, industry, or geography (governorate/wilayat). It is specifically suited for Oman-based company lookups with structured confidence scoring and location filtering — prefer it over generic web search when you need structured, machine-readable company intelligence with legal type and activity status.

## Known failure modes

- Query too short or empty returns validation error
- Limit out of range (below 1 or above 50) returns validation error
- Unknown governorate or wilayat strings may return zero matches
- Low-confidence matches may include irrelevant or inactive companies
- Network/payment failure returns 402 or 5xx error

## 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

Returns a JSON object with a list of matched companies (up to the specified limit), each including company ID, name, normalized name, legal type, industry, active/inactive status, website URL, wilayat, governorate, and a confidence score (0–1) indicating match quality, plus a total match count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1
  },
  "wilayat": {
   "type": "string",
   "maxLength": 60,
   "minLength": 1
  },
  "industry": {
   "type": "string",
   "maxLength": 120,
   "minLength": 1
  },
  "governorate": {
   "type": "string",
   "maxLength": 60,
   "minLength": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "matches": [
   {
    "status": "active",
    "website": "https://alnoortrading.om",
    "wilayat": "Muscat",
    "industry": "Trading",
    "companyId": "demo-co-1",
    "legalType": "LLC",
    "confidence": 0.79,
    "companyName": "Al Noor Trading LLC",
    "governorate": "Muscat",
    "normalizedName": "AL NOOR"
   },
   {
    "status": "active",
    "website": "https://muscat-trading.om",
    "wilayat": "Muttrah",
    "industry": "Trading",
    "companyId": "demo-co-4",
    "legalType": "SAOC",
    "confidence": 0.26,
    "companyName": "Muscat Trading Company",
    "governorate": "Muscat",
    "normalizedName": "MUSCAT"
   },
   {
    "status": "inactive",
    "website": null,
    "wilayat": "Sohar",
    "industry": "Construction",
    "companyId": "demo-co-5",
    "legalType": "LLC",
    "confidence": 0.19,
    "companyName": "Al Rawda Contracting LLC",
    "governorate": "Al Batinah North",
    "normalizedName": "AL RAWDA"
   }
  ],
  "totalMatches": 3
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rafid-business-search-api-69d575da/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)