Start building

FRED Get Category Series

https://api.sandbase.ai/v1/api/fred/category-series

Get Category Series from FRED. Returns the official FRED API response unchanged.

Try this APIGet API key
Price
$0USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
1 required · 11 optional
Production route

Try the model

Playground

Open playground
Input
The id for a category. integer, required
A semicolon delimited list of tag names that series match none of. String, optional, no filtering by tags by default. Example value: 'discontinued;annual'. Filter results to series having neither tag 'discontinued' nor tag 'annual'. Parameter exclude_tag_names requires that parameter tag_names also
Response format. Only json is supported. Allowed values: json.
The value of the filter_variable attribute to filter results by. String, optional, no filter by default
The attribute to filter results by. On of the following strings: 'frequency', 'units', 'seasonal_adjustment'. optional, no filter by default Allowed values: frequency, units, seasonal_adjustment.
11000
The maximum number of results to return. integer between 1 and 1000, optional, default: 1000 Range: 1 to 1000.
non-negative integer, optional, default: 0 Minimum: 0.
Order 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_i Allowed values: series_id, title, units, frequency, seasonal_adjustment, realtime_start, realtime_end, last_updated, observation_start, observation_end, popularity, group_popularity.
The end of the real-time period. For more information, see Real-Time Periods . YYYY-MM-DD formatted string, optional, default: today's date
The start of the real-time period. For more information, see Real-Time Periods . YYYY-MM-DD formatted string, optional, default: today's date
Sort results is ascending or descending order for attribute values specified by order_by. One of the following strings: 'asc', ' desc '. optional, default: asc Allowed values: asc, desc .
A semicolon delimited list of tag names that series match all of. String, optional, no filtering by tags by default Example value: 'income;bea'. Filter results to series having both tags 'income' and 'bea'. See the related request fred/tags .
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price
$0 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

category_id
integer · required
exclude_tag_names
string · optional
file_type
string (json) · optional
filter_value
string · optional
filter_variable
string (frequency, units, seasonal_adjustment) · optional
limit
integer · optional
offset
integer · optional
order_by
string (series_id, title, units, frequency, seasonal_adjustment, realtime_start, realtime_end, last_updated, observation_start, observation_end, popularity, group_popularity) · optional
realtime_end
string · optional
realtime_start
string · optional
sort_order
string (asc, desc ) · optional
tag_names
string · optional

Access

Provider
FRED
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/fred/category-series
Authentication
Bearer API key

API README

FRED Get Category Series API

Get Category Series from FRED. Returns the official FRED API response unchanged.

The response is the official FRED API response, unchanged.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "fred/category-series", "category_id": "<category_id>"}'

Parameters

NameTypeRequiredDescription
category_idintegerYesThe id for a category. integer, required
exclude_tag_namesstringNoA semicolon delimited list of tag names that series match none of. String, optional, no filtering by tags by default. Example value: 'discontinued;annual'. Filt
file_typestringNoResponse format. Only json is supported.
filter_valuestringNoThe value of the filter_variable attribute to filter results by. String, optional, no filter by default
filter_variablestringNoThe attribute to filter results by. On of the following strings: 'frequency', 'units', 'seasonal_adjustment'. optional, no filter by default
limitintegerNoThe maximum number of results to return. integer between 1 and 1000, optional, default: 1000
offsetintegerNonon-negative integer, optional, default: 0
order_bystringNoOrder results by values of the specified attribute. One of the following strings: 'series_id', 'title', 'units', 'frequency', 'seasonal_adjustment', 'realtime_s
realtime_endstringNoThe end of the real-time period. For more information, see Real-Time Periods . YYYY-MM-DD formatted string, optional, default: today's date
realtime_startstringNoThe start of the real-time period. For more information, see Real-Time Periods . YYYY-MM-DD formatted string, optional, default: today's date
sort_orderstringNoSort results is ascending or descending order for attribute values specified by order_by. One of the following strings: 'asc', ' desc '. optional, default: asc
tag_namesstringNoA semicolon delimited list of tag names that series match all of. String, optional, no filtering by tags by default Example value: 'income;bea'. Filter results

Pricing

Flat price per call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/fred/category-series
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/fred/category-series" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "limit": 1000,
  "offset": 0,
  "order_by": "series_id",
  "file_type": "json",
  "sort_order": "asc"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
FRED Get Category SeriesThis API
FRED		$0 per callJSONOct 30, 2026
FRED category
FRED		$0 per callJSONOct 30, 2026
FRED Get Category Children
FRED		$0 per callJSONOct 30, 2026
FRED Get Category Related
FRED		$0 per callJSONOct 30, 2026
FRED Get Category Related Tags
FRED		$0 per callJSONOct 30, 2026
FRED Get Category Tags
FRED		$0 per callJSONOct 30, 2026

Questions

FAQ

How do I use the FRED Get Category Series API?

Send a POST request to https://api.sandbase.ai/v1/api/fred/category-series with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the FRED Get Category Series API cost?

$0 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the FRED Get Category Series API accept?

Required: category_id (integer). Optional: exclude_tag_names (string), file_type (one of json), filter_value (string), filter_variable (one of frequency, units, seasonal_adjustment), limit (integer) and offset (integer) and 5 more. The Parameters table and the Playground on this page list every field.

What does the FRED Get Category Series API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a FRED developer account or API key?

No. FRED Get Category Series runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for FRED API access separately.