# GMD — Global Machine Directory Business Search

> GMD — Global Machine Directory Business Search is a paid API for AI agents from property-change-x402-production.up.railway.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Search a machine-payable business directory by category and location, returning public phone evidence and provenance for matching businesses.

## Facts

- Endpoint: POST https://property-change-x402-production.up.railway.app/v1/directory/search
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gmd-global-machine-directory-business-search-776ec7c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KKi0TACFVB8bc919A8sKJ

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 gmd-global-machine-directory-business-search-776ec7c3 -d '<json body>'
```

Example prompt: Search the Global Machine Directory for up to 10 dentists in San Francisco, CA and give me their contact details with source provenance.

## When to prefer this

Choose this endpoint when an AI agent needs structured, machine-payable access to a business directory with phone evidence and provenance — particularly for US city+state+category lookups where verifiable contact data matters. Prefer over generic web search when you need structured JSON output with sourced phone numbers rather than scraped or unverified web results.

## Known failure modes

- Empty results array returned when no businesses match the category/location combination
- Invalid or unsupported US state abbreviation causes query failure or empty response
- Limit value outside 1–25 range rejected by schema validation
- Missing required fields (city, state, or category) may result in malformed query or error
- Payment failure (x402) prevents query from completing if USDC balance is insufficient

## How this service works

Verified business leads for AI agents: structured business records with public phone, website and other contact intelligence, provenance, verification and freshness when available. $0.02 USDC per requested result.

## Output

A JSON object containing the search query echo, result count, a list of matching business entries with public phone numbers and provenance metadata, and payment confirmation. Returns an empty results array if no matches are found for the given city, state, and category combination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "city": {
   "type": "string",
   "description": "City name"
  },
  "limit": {
   "type": "integer",
   "maximum": 10000,
   "minimum": 1,
   "description": "Maximum results. Price is $0.02 USDC per requested result."
  },
  "state": {
   "type": "string",
   "description": "US state abbreviation, e.g. CA"
  },
  "category": {
   "type": "string",
   "description": "Business category, e.g. dentist, electrician, plumber or HVAC"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 5,
  "query": {
   "city": "San Francisco",
   "limit": 5,
   "state": "CA",
   "category": "dentist"
  },
  "payment": null,
  "pricing": {
   "priceUsd": 0.1,
   "requestedResults": 5,
   "pricePerResultUsd": 0.02
  },
  "results": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gmd-global-machine-directory-business-search-776ec7c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from property-change-x402-production.up.railway.app](https://www.zero.xyz/host/property-change-x402-production.up.railway.app/llms.txt)