API reference · FRED

fred/release-series

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

APISynchronousOpen model
Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/api/fred/release-series
Model IDfred/release-series
01

Input Schema

12 parameters · 1 required · 11 optional

ParameterTypeRequiredDescription
release_idintegerRequiredThe id for a release. integer, required
limitintegerOptionalThe maximum number of results to return. integer between 1 and 1000, optional, default: 1000 · Min: 1 · Max: 1000 · Default: 1000
offsetintegerOptionalnon-negative integer, optional, default: 0 · Min: 0 · Default: 0
order_bystringOptionalOrder results by values of the specified attribute. One of the following strings: 'series_id', 'title', 'units', 'frequency', 'seasonal_adjustment', 'realtime_start', 'realtime_end', 'last_updated', 'observation_start', 'observation_end', 'popularity','group_popularity'. optional, default: series_id · Options: series_id, title, units, frequency, seasonal_adjustment, realtime_start, realtime_end, last_updated, observation_start, observation_end, popularity, group_popularity · Default: "series_id"
series_idtitleunitsfrequencyseasonal_adjustmentrealtime_startrealtime_endlast_updatedobservation_startobservation_endpopularitygroup_popularity
file_typestringOptionalResponse format. Only json is supported. · Options: json · Default: "json"
json
tag_namesstringOptionalA semicolon delimited list of tag names that series match all of. String, optional, no filtering by tags by default Example value: 'japan;imports'. Filter results to series having both tags 'japan' and 'imports'. See the related request fred/tags .
sort_orderstringOptionalSort results is ascending or descending order for attribute values specified by order_by. One of the following strings: 'asc', 'desc'. optional, default: asc · Options: asc, desc · Default: "asc"
ascdesc
filter_valuestringOptionalThe value of the filter_variable attribute to filter results by. String, optional, no filter by default
realtime_endstringOptionalThe end of the real-time period. For more information, see Real-Time Periods . YYYY-MM-DD formatted string, optional, default: today's date
realtime_startstringOptionalThe start of the real-time period. For more information, see Real-Time Periods . YYYY-MM-DD formatted string, optional, default: today's date
filter_variablestringOptionalThe attribute to filter results by. One of the following strings: 'frequency', 'units', 'seasonal_adjustment'. optional, no filter by default · Options: frequency, units, seasonal_adjustment
frequencyunitsseasonal_adjustment
exclude_tag_namesstringOptionalA semicolon delimited list of tag names that series match none of. String, optional, no filtering by tags by default. Example value: 'imports;services'. Filter results to series having neither tag 'imports' nor tag 'services'. Parameter exclude_tag_names requires that parameter tag_names also be set
02

Output Schema

FieldTypeDescription
idstringUnique identifier for the generation task
statusstringTask status: pending, running, completed, failed, timeout
modelstringModel used for the generation
outputsarrayArray of output items
outputs[].urlstringURL of the generated artifact
outputs[].content_typestringMIME type (e.g. image/png, video/mp4)
errorobject | nullError details if failed, null on success
error.typestringMachine-readable error type code
error.messagestringHuman-readable error description
03

Code Examples

Ready-to-run snippets

const apiKey = process.env.SANDBASE_API_KEY;
const response = await fetch("https://api.sandbase.ai/v1/api/fred/release-series", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "limit": 1000,
    "offset": 0,
    "order_by": "series_id",
    "file_type": "json",
    "sort_order": "asc"
  }),
});

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());