{"uid":"cap_f9Tb0hXUuLWU3Ip03IVYL","slug":"msha-entity-fuzzy-name-resolver-26a8b8fa","name":"MSHA Entity Fuzzy Name Resolver","description":"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.","url":"https://miningincidents.org/api/x402/resolve","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6b6BqdBBwswvfgJyW99aF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves approximate or misspelled mine operator/mine names to ranked canonical MSHA entity IDs with fatality and violation summaries","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:43:31.953Z","isFirstParty":false}