# MSHA Entity Fuzzy Name Resolver

> MSHA Entity Fuzzy Name Resolver is a paid API for AI agents from miningincidents.org, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Resolves approximate or misspelled mine operator/mine names to ranked canonical MSHA entity IDs with fatality and violation summaries

## Facts

- Endpoint: GET https://miningincidents.org/api/x402/resolve
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/msha-entity-fuzzy-name-resolver-26a8b8fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f9Tb0hXUuLWU3Ip03IVYL

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 msha-entity-fuzzy-name-resolver-26a8b8fa
```

Example prompt: Can you find the official MSHA operator ID for a company whose name is something like 'Consol Energie' — search operators only and show me the top matches with their fatality and violation summaries?

## When to prefer this

Use this endpoint when you have an approximate, misspelled, or partially known mine or operator name and need to resolve it to an official MSHA entity ID before fetching detailed safety records. Prefer this over exact-match lookups when user input is free-form or potentially erroneous. It is the natural first step in any MSHA data pipeline where entity identity is uncertain.

## Known failure modes

- Name too short (under 2 characters) returns validation error
- No close matches found returns empty ranked list
- Invalid 'kind' enum value returns 400 bad request
- Name exceeding 120 characters returns validation error
- Network timeout if MSHA data source is temporarily unavailable

## How this service works

Fuzzy entity resolver: an approximate or misspelled operator or mine name returns ranked canonical MSHA entity ids with aggregate fatality and violation summaries. Built from paid feature request #1.

## Output

A ranked list of canonical MSHA entity IDs matching the approximate input name, each with the official entity name, entity type (operator or mine), aggregate fatality count, and violation summary statistics

## 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",
     "properties": {
      "kind": {
       "enum": [
        "operator",
        "mine"
       ],
       "type": "string",
       "description": "optional filter; omit to search both kinds"
      },
      "name": {
       "type": "string",
       "maxLength": 120,
       "minLength": 2,
       "description": "approximate or misspelled operator or mine name"
      }
     }
    }
   },
   "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/msha-entity-fuzzy-name-resolver-26a8b8fa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from miningincidents.org](https://www.zero.xyz/host/miningincidents.org/llms.txt)