{ "opencollection": "1.0.0", "info": { "name": "FRED Maps API (GeoFRED) Categories Releases API", "version": "1.0" }, "request": { "auth": { "type": "apikey", "key": "api_key", "value": "{{api_key}}", "placement": "query" } }, "items": [ { "info": { "name": "Releases", "type": "folder" }, "items": [ { "info": { "name": "FRED Get All Releases of Economic Data", "type": "http" }, "http": { "method": "GET", "url": "https://api.stlouisfed.org/geofred/releases", "params": [ { "name": "api_key", "value": "abcdef0123456789abcdef0123456789", "type": "query", "description": "32-character lower-case alphanumeric FRED API key." }, { "name": "file_type", "value": "json", "type": "query", "description": "Response format. xml (default) or json. The observations endpoint additionally accepts xlsx and csv." }, { "name": "realtime_start", "value": "2026-05-28", "type": "query", "description": "Start of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "realtime_end", "value": "2026-05-28", "type": "query", "description": "End of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "limit", "value": "100", "type": "query", "description": "Maximum number of results to return (1–1000)." }, { "name": "offset", "value": "0", "type": "query", "description": "Non-negative integer offset into the result set for pagination." }, { "name": "order_by", "value": "series_count", "type": "query", "description": "Field to order release results by." }, { "name": "sort_order", "value": "asc", "type": "query", "description": "Sort order. asc (ascending, default) or desc (descending)." } ] }, "docs": "Get all releases of economic data." }, { "info": { "name": "FRED Get Release Dates for All Releases of Economic Data", "type": "http" }, "http": { "method": "GET", "url": "https://api.stlouisfed.org/geofred/releases/dates", "params": [ { "name": "api_key", "value": "abcdef0123456789abcdef0123456789", "type": "query", "description": "32-character lower-case alphanumeric FRED API key." }, { "name": "file_type", "value": "json", "type": "query", "description": "Response format. xml (default) or json. The observations endpoint additionally accepts xlsx and csv." }, { "name": "realtime_start", "value": "2026-05-28", "type": "query", "description": "Start of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "realtime_end", "value": "2026-05-28", "type": "query", "description": "End of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "limit", "value": "100", "type": "query", "description": "Maximum number of results to return (1–1000)." }, { "name": "offset", "value": "0", "type": "query", "description": "Non-negative integer offset into the result set for pagination." }, { "name": "order_by", "value": "series_count", "type": "query", "description": "Ordering field." }, { "name": "sort_order", "value": "asc", "type": "query", "description": "Sort order. asc (ascending, default) or desc (descending)." }, { "name": "include_release_dates_with_no_data", "value": "false", "type": "query", "description": "Include releases that have no data." } ] }, "docs": "Get release dates for all releases of economic data." }, { "info": { "name": "FRED Get a Release of Economic Data", "type": "http" }, "http": { "method": "GET", "url": "https://api.stlouisfed.org/geofred/release", "params": [ { "name": "api_key", "value": "abcdef0123456789abcdef0123456789", "type": "query", "description": "32-character lower-case alphanumeric FRED API key." }, { "name": "file_type", "value": "json", "type": "query", "description": "Response format. xml (default) or json. The observations endpoint additionally accepts xlsx and csv." }, { "name": "release_id", "value": "9", "type": "query", "description": "Numeric release ID." }, { "name": "realtime_start", "value": "2026-05-28", "type": "query", "description": "Start of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "realtime_end", "value": "2026-05-28", "type": "query", "description": "End of the real-time period (YYYY-MM-DD). Defaults to today." } ] }, "docs": "Get a release of economic data by ID." }, { "info": { "name": "FRED Get the Release Dates for a Release of Economic Data", "type": "http" }, "http": { "method": "GET", "url": "https://api.stlouisfed.org/geofred/release/dates", "params": [ { "name": "api_key", "value": "abcdef0123456789abcdef0123456789", "type": "query", "description": "32-character lower-case alphanumeric FRED API key." }, { "name": "file_type", "value": "json", "type": "query", "description": "Response format. xml (default) or json. The observations endpoint additionally accepts xlsx and csv." }, { "name": "release_id", "value": "9", "type": "query", "description": "Numeric release ID." }, { "name": "realtime_start", "value": "2026-05-28", "type": "query", "description": "Start of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "realtime_end", "value": "2026-05-28", "type": "query", "description": "End of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "limit", "value": "100", "type": "query", "description": "Maximum number of results to return (1–10000)." }, { "name": "offset", "value": "0", "type": "query", "description": "Non-negative integer offset into the result set for pagination." }, { "name": "sort_order", "value": "asc", "type": "query", "description": "Sort by release date." }, { "name": "include_release_dates_with_no_data", "value": "false", "type": "query", "description": "Include dates that have no data attached." } ] }, "docs": "Get the release dates for a release of economic data." }, { "info": { "name": "FRED Get the Series on a Release of Economic Data", "type": "http" }, "http": { "method": "GET", "url": "https://api.stlouisfed.org/geofred/release/series", "params": [ { "name": "api_key", "value": "abcdef0123456789abcdef0123456789", "type": "query", "description": "32-character lower-case alphanumeric FRED API key." }, { "name": "file_type", "value": "json", "type": "query", "description": "Response format. xml (default) or json. The observations endpoint additionally accepts xlsx and csv." }, { "name": "release_id", "value": "9", "type": "query", "description": "Numeric release ID." }, { "name": "realtime_start", "value": "2026-05-28", "type": "query", "description": "Start of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "realtime_end", "value": "2026-05-28", "type": "query", "description": "End of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "limit", "value": "100", "type": "query", "description": "Maximum number of results to return (1–1000)." }, { "name": "offset", "value": "0", "type": "query", "description": "Non-negative integer offset into the result set for pagination." }, { "name": "order_by", "value": "series_count", "type": "query", "description": "Field to order series results by." }, { "name": "sort_order", "value": "asc", "type": "query", "description": "Sort order. asc (ascending, default) or desc (descending)." }, { "name": "filter_variable", "value": "frequency", "type": "query", "description": "Attribute to filter series results by." }, { "name": "filter_value", "value": "monthly", "type": "query", "description": "Value of the filter_variable attribute to match." }, { "name": "tag_names", "value": "monthly;usa", "type": "query", "description": "Semicolon-separated list of tag names to require." }, { "name": "exclude_tag_names", "value": "discontinued", "type": "query", "description": "Semicolon-separated list of tag names to exclude." } ] }, "docs": "Get the series on a release of economic data." }, { "info": { "name": "FRED Get the Sources for a Release of Economic Data", "type": "http" }, "http": { "method": "GET", "url": "https://api.stlouisfed.org/geofred/release/sources", "params": [ { "name": "api_key", "value": "abcdef0123456789abcdef0123456789", "type": "query", "description": "32-character lower-case alphanumeric FRED API key." }, { "name": "file_type", "value": "json", "type": "query", "description": "Response format. xml (default) or json. The observations endpoint additionally accepts xlsx and csv." }, { "name": "release_id", "value": "9", "type": "query", "description": "Numeric release ID." }, { "name": "realtime_start", "value": "2026-05-28", "type": "query", "description": "Start of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "realtime_end", "value": "2026-05-28", "type": "query", "description": "End of the real-time period (YYYY-MM-DD). Defaults to today." } ] }, "docs": "Get the sources for a release of economic data." }, { "info": { "name": "FRED Get the Tags for a Release", "type": "http" }, "http": { "method": "GET", "url": "https://api.stlouisfed.org/geofred/release/tags", "params": [ { "name": "api_key", "value": "abcdef0123456789abcdef0123456789", "type": "query", "description": "32-character lower-case alphanumeric FRED API key." }, { "name": "file_type", "value": "json", "type": "query", "description": "Response format. xml (default) or json. The observations endpoint additionally accepts xlsx and csv." }, { "name": "release_id", "value": "9", "type": "query", "description": "Numeric release ID." }, { "name": "realtime_start", "value": "2026-05-28", "type": "query", "description": "Start of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "realtime_end", "value": "2026-05-28", "type": "query", "description": "End of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "tag_names", "value": "monthly;usa", "type": "query", "description": "Semicolon-separated list of tag names to require." }, { "name": "tag_group_id", "value": "freq", "type": "query", "description": "Group identifier for tags — freq, gen, geo, geot, rls, seas, src." }, { "name": "search_text", "value": "monetary aggregates", "type": "query", "description": "Words to match against tag names and descriptions." }, { "name": "limit", "value": "100", "type": "query", "description": "Maximum number of results to return (1–1000)." }, { "name": "offset", "value": "0", "type": "query", "description": "Non-negative integer offset into the result set for pagination." }, { "name": "order_by", "value": "series_count", "type": "query", "description": "Field to order tag results by." }, { "name": "sort_order", "value": "asc", "type": "query", "description": "Sort order. asc (ascending, default) or desc (descending)." } ] }, "docs": "Get the FRED tags for a release." }, { "info": { "name": "FRED Get the Related Tags for a Release", "type": "http" }, "http": { "method": "GET", "url": "https://api.stlouisfed.org/geofred/release/related_tags", "params": [ { "name": "api_key", "value": "abcdef0123456789abcdef0123456789", "type": "query", "description": "32-character lower-case alphanumeric FRED API key." }, { "name": "file_type", "value": "json", "type": "query", "description": "Response format. xml (default) or json. The observations endpoint additionally accepts xlsx and csv." }, { "name": "release_id", "value": "9", "type": "query", "description": "Numeric release ID." }, { "name": "realtime_start", "value": "2026-05-28", "type": "query", "description": "Start of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "realtime_end", "value": "2026-05-28", "type": "query", "description": "End of the real-time period (YYYY-MM-DD). Defaults to today." }, { "name": "tag_names", "value": "monthly;usa", "type": "query", "description": "Semicolon-separated list of tag names to require." }, { "name": "exclude_tag_names", "value": "discontinued", "type": "query", "description": "Semicolon-separated list of tag names to exclude." }, { "name": "tag_group_id", "value": "freq", "type": "query", "description": "Group identifier for tags — freq, gen, geo, geot, rls, seas, src." }, { "name": "search_text", "value": "monetary aggregates", "type": "query", "description": "Words to match against tag names and descriptions." }, { "name": "limit", "value": "100", "type": "query", "description": "Maximum number of results to return (1–1000)." }, { "name": "offset", "value": "0", "type": "query", "description": "Non-negative integer offset into the result set for pagination." }, { "name": "order_by", "value": "series_count", "type": "query", "description": "Field to order tag results by." }, { "name": "sort_order", "value": "asc", "type": "query", "description": "Sort order. asc (ascending, default) or desc (descending)." } ] }, "docs": "Get the related FRED tags for one or more FRED tags within a release." }, { "info": { "name": "FRED Get Release Tables", "type": "http" }, "http": { "method": "GET", "url": "https://api.stlouisfed.org/geofred/release/tables", "params": [ { "name": "api_key", "value": "abcdef0123456789abcdef0123456789", "type": "query", "description": "32-character lower-case alphanumeric FRED API key." }, { "name": "file_type", "value": "json", "type": "query", "description": "Response format. xml (default) or json. The observations endpoint additionally accepts xlsx and csv." }, { "name": "release_id", "value": "9", "type": "query", "description": "Numeric release ID." }, { "name": "element_id", "value": "12886", "type": "query", "description": "Optional element of the release table to root the tree at." }, { "name": "include_observation_values", "value": "false", "type": "query", "description": "Include observation values inline." }, { "name": "observation_date", "value": "2026-04-01", "type": "query", "description": "Date of the observations to include (YYYY-MM-DD)." } ] }, "docs": "Get release table trees for a given release. Returns the table tree of a release." } ] } ], "bundled": true }