# match-name

> match-name is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Compares two company or entity names using fuzzy matching and normalization to return a confidence score for deduplication and record linkage.

## Facts

- Endpoint: GET https://payai.agentstools.dev/match/name
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/match-name-af9641dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4vLrqrwkE1-Hm-tppTsQC

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 match-name-af9641dd
```

Example prompt: Can you check whether 'International Business Machines Corp.' and 'IBM Corporation' are the same company and give me a match confidence score? Use the company entity type.

## When to prefer this

Use this endpoint when you need to determine if two company or entity names refer to the same real-world organization, especially for deduplication pipelines, CRM data cleaning, or joining datasets from different sources that may use inconsistent name formatting. It is preferable over simple string equality checks when names may include abbreviations, legal suffixes, punctuation differences, or alternate spellings.

## Known failure modes

- Missing required query parameters 'a' or 'b' returns a 400 error
- Empty string inputs may produce low-confidence scores rather than an error
- Very short or ambiguous names (e.g. single letters) may yield unreliable confidence scores
- Unsupported entity type value causes validation error
- Network or upstream service failure returns 5xx error

## How this service works

Fuzzy-match two names or addresses and return a 0-100 similarity score with a match decision. Normalizes legal forms, business stop-words, person titles and address abbreviations BEFORE the fuzzy compare, then fuses token, prefix, phonetic and edit similarity. Returns the score, the per-component scores, the normalized forms and is_match. Similarity indicators, not authoritative identity resolution.

## Output

Returns fuzzy match signals, normalized forms of both input names, and a numeric confidence score (0-100) indicating how likely the two names refer to the same entity, along with match/no-match determination based on the per-type or user-specified threshold.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "a",
      "b"
     ],
     "properties": {
      "a": {
       "type": "string",
       "description": "First string to compare"
      },
      "b": {
       "type": "string",
       "description": "Second string to compare"
      },
      "type": {
       "enum": [
        "person",
        "company",
        "address",
        "product",
        "org"
       ],
       "type": "string",
       "description": "Entity type selecting the normalization pipeline (default company)"
      },
      "min_score": {
       "type": "integer",
       "description": "Optional match threshold 0-100 (default is the per-type threshold)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/match-name-af9641dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)