# 402utils Deduplicate Records

> 402utils Deduplicate Records is a paid API for AI agents from 402utils.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

De-duplicates a list of objects or strings using exact key matching or fuzzy Levenshtein similarity grouping, returning unique and duplicate items with indices.

## Facts

- Endpoint: POST https://402utils.com/v1/dedupe
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/402utils-deduplicate-records-c86989a6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0iPD1EQdSHKP6hp7Iad-9

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 402utils-deduplicate-records-c86989a6 -d '<json body>'
```

Example prompt: Can you deduplicate this list of customer names — ['Jean Dupont', 'jean dupont', 'Jean Martin', 'JEAN DUPONT'] — using fuzzy matching with a similarity threshold of 0.85, comparing the whole string?

## When to prefer this

Use this endpoint when you need programmatic, pay-per-call deduplication with support for both exact key-based matching and fuzzy Levenshtein similarity — especially useful for cleaning messy real-world data like names, addresses, or company records where typos and case differences are common. Prefer this over building your own logic when you need fast, stateless deduplication with index tracking in a single API call.

## Known failure modes

- More than 1000 items submitted in fuzzy mode — endpoint rejects with an error
- Invalid dot-path key field that doesn't exist on input objects — may produce unexpected grouping
- Threshold outside (0,1] range — validation error returned
- Mixing scalar and object items without a consistent key — undefined or error behavior
- Payment not included or insufficient — 402 payment required response

## How this service works

De-duplicate a list of records or strings. Exact: group by a `key` field (dot-path) or, by default, the whole item (key-order-insensitive). Fuzzy (`fuzzy`: a field name, or true for scalar strings): group by normalized Levenshtein similarity ≥ `threshold` (default 0.85) — e.g. 'Jean Dupont' ≈ 'jean  dupont' but 'Jean Martin' stays separate. Returns unique[] and duplicates[] (kept + dropped indices). Fuzzy ≤ 1000 items.

## Output

A JSON object with two arrays: `unique` (the representative items from each group) and `duplicates` (objects containing each duplicate's kept and dropped indices within the original list), allowing the caller to trace exactly which input items were merged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "key": {
   "type": "string",
   "description": "Exact mode: dot-path to the field that identifies a duplicate. Omit to dedupe whole items."
  },
  "fuzzy": {
   "description": "Fuzzy mode: a field name (dot-path) to compare, or true to compare scalar strings whole."
  },
  "items": {
   "type": "array",
   "description": "The values to deduplicate (objects or scalars)."
  },
  "threshold": {
   "type": "number",
   "default": 0.85,
   "maximum": 1,
   "minimum": 0,
   "description": "Fuzzy similarity threshold in (0,1]. Higher = stricter. Default 0.85."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/402utils-deduplicate-records-c86989a6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 402utils.com](https://www.zero.xyz/host/402utils.com/llms.txt)
