# Interzoid Full Name Match Score API

> Interzoid Full Name Match Score API is a paid API for AI agents from api.interzoid.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Compares two full person names and returns an AI-powered similarity/match score indicating how likely they refer to the same person

## Facts

- Endpoint: GET https://api.interzoid.com/getfullnamematchscore
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/interzoid-full-name-match-score-api-44a4070e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lKmJc17YezDoEXwOi9op1

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 interzoid-full-name-match-score-api-44a4070e
```

Example prompt: Can you compare these two names and tell me how likely they are the same person — 'Jonathan R. Smith' and 'Jon Smith'? I need a match score to decide if these are duplicate records.

## When to prefer this

Use this endpoint when you need to detect duplicate or variant person names in CRM, ERP, MDM, or analytics systems. It is specifically designed for full person names (first + last) and uses AI-powered SmartMatchAI logic that understands nicknames, misspellings, initials, and cultural name variants — superior to simple string distance metrics for person names.

## Known failure modes

- Missing fullname1 or fullname2 parameter returns an error response
- Empty string inputs may return a low or zero score rather than an error
- Very short or single-character names may produce unreliable scores
- Network timeout if the API is temporarily unavailable
- Payment/402 failure if USDC balance is insufficient

## How this service works

Compare two individual/person names and receive a match score from 0-100 indicating how similar they are. Handles name order, nicknames, and abbreviations.

## Output

Returns a JSON object with a Code field ('Success' on success), a Score field (numeric string, e.g. '88', representing match similarity from 0-100), and a Credits field indicating remaining API credits.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "fullname1": "Jonathan R. Smith",
   "fullname2": "Jon Smith"
  }
 }
}
```

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "fullname1",
      "fullname2"
     ],
     "properties": {
      "fullname1": {
       "type": "string",
       "description": "First full name"
      },
      "fullname2": {
       "type": "string",
       "description": "Second full name to compare"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "Code": "Success",
  "Score": "88",
  "Credits": "0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/interzoid-full-name-match-score-api-44a4070e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.interzoid.com](https://www.zero.xyz/host/api.interzoid.com/llms.txt)