{"uid":"cap_MfWrt0VrWrrWZHZ0izTsp","slug":"fathom-macroeconomic-data-api-release-dates-4340be93","name":"Fathom Macroeconomic Data API — Release Dates","description":"Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.","url":"https://fredthom.vercel.app/api/release-dates","method":"POST","headers":{},"bodySchema":{"type":"object","required":["releaseId"],"properties":{"limit":{"type":"string","description":"Max results (default: 10)"},"releaseId":{"type":"string","description":"FRED release ID"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"dates":{"type":"array","items":{"type":"object"}},"source":{"type":"string"},"release_id":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.4","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.4/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5mfJZ7sbXCo7ypme5hBXf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.4","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the scheduled and historical release dates for a specific FRED economic data release, given a release ID","exampleAgentPrompt":"Can you pull the last 5 release dates for FRED release ID 21 — I want to see when the GDP data has been published recently?","exampleUseCases":null,"resultDescription":"An array of release date objects for the specified FRED release, along with the source identifier and release ID. Each item in the dates array contains scheduling/publication date information for that economic data release.","failureModes":["Missing or invalid releaseId returns an error — FRED release IDs must be valid numeric identifiers","No release dates found for a valid but obscure release ID returns an empty dates array","Limit parameter ignored or defaulted to 10 if not supplied or malformed","Network/service unavailability on Vercel hosting returns 5xx error","Payment not processed (x402 protocol failure) results in 402 response before data is returned"],"whenToPreferThis":"Use this endpoint when you need to know the publication schedule or historical release dates for a specific macroeconomic data series from FRED — for example, to track when GDP, CPI, or unemployment figures are published. Prefer this over general time-series endpoints when your goal is scheduling/calendar metadata about a release rather than the actual data values.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:33:13.492Z","isFirstParty":false}