{"uid":"cap_WqOz871RfHTSYYIT5jhD8","slug":"usgs-earthquake-event-lookup-9ea02b26","name":"USGS Earthquake Event Lookup","description":"Pay-per-request evidence and data tools: CSV validation and reconciliation, DNS/email configuration evidence, and bounded official weather, earthquake, vehicle, company and study records. Exact USDC prices, explicit JSON contracts and source provenance. No mailbox, ownership, medical or safety guarantees.","url":"https://foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev/v2/official/usgs-earthquake-event","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"event_id":{"type":"string","pattern":"^[a-zA-Z0-9]{5,40}$"}}},"responseSchema":{"type":"json","example":{"route":"usgs-earthquake-event","result":{"query":{"event_id":"us7000m9g4"},"source":"USGS Earthquake Catalog","freshness":{"state":"CURRENT_RETRIEVAL","retrievedAt":"2026-09-06T00:00:00Z","cacheAgeSeconds":0,"maximumCacheSeconds":30,"recordAgeIsNotRetrievalAge":true},"sourceUrl":"https://earthquake.usgs.gov","observedAt":"2026-09-06T00:00:00Z","provenance":{"license":"US public-domain earthquake facts; no third-party media","termsUrl":"https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits","truncated":false,"attribution":"US Geological Survey and the contributing seismic network identified in each record","limitations":["Synthetic example only; identifiers and null values illustrate fields, not a live observation."],"modifications":"Selected factual fields, normalized names and bounded result count; no source ownership claimed.","upstreamCalls":1,"documentationUrl":"https://earthquake.usgs.gov/fdsnws/event/1/"},"sourceUpdatedAt":null,"normalizedResult":[{"id":"illustrative-record","place":null,"status":null,"network":null,"eventTime":null,"magnitude":null,"sourceUrl":null,"updatedAt":null,"coordinates":null}],"sourceProcessedAt":null,"rawSourceIdentifiers":[]},"observed_at":"2026-09-06T00:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LcQEBxTNLymf_KMsCjDw4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a single USGS earthquake event ID into its current factual record from the USGS Earthquake Catalog, including event metadata and seismic network attribution.","exampleAgentPrompt":"Can you pull the USGS earthquake catalog record for event ID us7000m9g4 and tell me what it says about location, magnitude, and the contributing seismic network?","exampleUseCases":[{"title":"Verify reported earthquake event details","prompt":"I saw a news report referencing USGS earthquake event us7000m9g4 — can you look that up and give me the official details from the USGS catalog?"},{"title":"Enrich seismic alert with event metadata","prompt":"We just got an alert with USGS event ID nc73921360 — can you fetch the full earthquake record for that event so I can include it in our incident report?"},{"title":"Research historical earthquake by known ID","prompt":"I have a list of USGS earthquake event IDs from last year — start with us6000jllz and pull the catalog record so I can see the magnitude, location, and which seismic network reported it."}],"resultDescription":"A JSON object containing the queried event ID, source attribution to the USGS Earthquake Catalog, freshness/cache metadata (retrieval timestamp, cache age, max cache seconds), provenance details (license, terms URL, upstream call count, documentation URL), and a normalizedResult array with the earthquake event fields. Includes observedAt timestamp and sourceUrl pointing to earthquake.usgs.gov.","failureModes":["Invalid or malformed event_id (must be 5-40 alphanumeric characters) returns a validation error","Unknown or non-existent event ID returns an empty normalizedResult array","USGS upstream unavailability may result in stale or failed retrieval","Payment not completed via x402 USDC results in 402 response before data is returned"],"whenToPreferThis":"Use this endpoint when you have a specific USGS earthquake event ID and need to resolve it to a full catalog record. Prefer this over the list/search earthquake endpoint when you already know the exact event identifier. It provides authoritative USGS public-domain data with provenance tracking, making it suitable for compliance, reporting, and research workflows where source attribution matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:42:14.325Z","isFirstParty":false}