{"uid":"cap_GawlrVSTzO01gnwNBIXI9","slug":"msha-mines-search-8db93928","name":"MSHA Mines Search","description":"Which mines and quarries operate in a market, and who runs them? Search the MSHA Mines data set — every coal and metal/non-metal mine under MSHA jurisdiction (NAICS-21 operators that are OSHA-exempt and invisible elsewhere) — by operator, mine name, state, county, commodity, canvass, coal_metal, mine type, status, active-only, or status date (since). Returns the mine, its operator (entity-resolved) and controller, commodity, employees, and status. MSHA public-domain records.","url":"https://api.govparse.io/v1/msha/mines/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":[],"properties":{"sort":{"type":"string","examples":["status_dt:desc"],"description":"status_dt | mine_name | employees :asc|:desc. Default status_dt:desc."},"limit":{"type":"integer","examples":[25],"description":"Max rows (default 25, cap 100)."},"since":{"type":"string","examples":["2026-01-01"],"description":"Current-status date on/after this date (YYYY-MM-DD) — surfaces newly-statused mines."},"state":{"type":"string","examples":["WV"],"description":"State code(s), CSV."},"active":{"type":"string","examples":["true"],"description":"true = currently-active mines only."},"county":{"type":"string","examples":["Boone"],"description":"County name fragment."},"offset":{"type":"integer","examples":[0],"description":"Rows to skip."},"status":{"type":"string","examples":["Active"],"description":"Mine status (Active | Abandoned | Intermittent | Temporarily Idled | NonProducing), CSV."},"canvass":{"type":"string","examples":["Stone"],"description":"Primary canvass (Coal | M/NM | Metal | Nonmetal | Sand & gravel | Stone), CSV."},"mine_id":{"type":"string","examples":["1202215"],"description":"MSHA mine id(s), CSV."},"operator":{"type":"string","examples":["Peabody"],"description":"Mine operator/company name — suffix/punctuation-insensitive."},"commodity":{"type":"string","examples":["Sand & Gravel"],"description":"Commodity/SIC or canvass fragment."},"entity_id":{"type":"string","examples":["b7f3e2d1-4a5c-4e6f-8a9b-0c1d2e3f4a5b"],"description":"Resolved operator entity UUID (pivots to business360)."},"mine_name":{"type":"string","examples":["Quarry"],"description":"Mine name fragment."},"mine_type":{"type":"string","examples":["Surface"],"description":"Surface | Underground | Facility (CSV)."},"coal_metal":{"type":"string","examples":["M"],"description":"C = coal, M = metal/non-metal."},"controller":{"type":"string","examples":["Vulcan"],"description":"Controlling entity (parent) name fragment."},"operator_id":{"type":"string","examples":["M09902"],"description":"MSHA operator id(s), CSV."}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1.25","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":"$1.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Yh0FKeVYlLBBvAdPVDCi3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search MSHA-regulated coal and metal/non-metal mines and quarries by operator, name, location, commodity, type, or status to identify who operates what mines and where","exampleAgentPrompt":"Find all active surface coal mines in West Virginia operated by Arch Resources — show me the mine name, operator, commodity, employee count, and current status for each one.","exampleUseCases":[{"title":"Competitive landscape for mining market","prompt":"I'm doing a market analysis on sand and gravel producers in Ohio — can you pull all active MSHA-registered sand and gravel mines there, sorted by most recently statused, and show me who operates each one and how many employees they have?"},{"title":"Supply chain operator due diligence","prompt":"We're vetting a potential supplier — can you look up all mines currently operated by Vulcan Materials in the MSHA database and tell me what states they're in, what commodities they mine, and whether any are abandoned or idled?"},{"title":"Monitor newly activated mines","prompt":"Can you show me any coal or metal mines in Appalachia — West Virginia, Kentucky, and Virginia — that changed status on or after January 1, 2025, so I can track which ones just came back online or went idle?"}],"resultDescription":"Returns a list of mine records matching the query, each containing the MSHA mine ID, mine name, mine type (Surface/Underground/Facility), operator name (entity-resolved), controller name, state, county, commodity, canvass category, coal/metal designation, employee count, current status, and status date. Results are paginated (default 25, max 100) and sortable by status date, mine name, or employee count.","failureModes":["No results returned when operator name spelling differs significantly from MSHA records — use fragment/partial strings","State must be a valid two-letter state code; invalid codes return empty results","Date format errors (non-YYYY-MM-DD) may cause 400 bad request","Limit exceeding 100 is capped or rejected","entity_id UUID that does not match any resolved operator returns empty set","Some mines may lack employee data if not reported to MSHA","$1.25 USDC payment required per call; unpaid requests return 402"],"whenToPreferThis":"Use this endpoint when you need to identify who operates coal or metal/non-metal mines under MSHA jurisdiction — these operators are OSHA-exempt and do not appear in standard business or OSHA databases. Ideal for competitive intelligence on mining companies, supply chain due diligence on raw material suppliers, regulatory compliance research, or monitoring mine status changes in a specific geography. Prefer this over general business search tools when the target industry is mining or quarrying (NAICS-21).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:52:35.665Z","isFirstParty":false}