GDP release dates API
The GDP release dates API returns recorded gross domestic product release schedules for the United States, United Kingdom, euro area, China and Japan as JSON, with reference periods and release times where recorded. Each country has a separate series code. History and supported official actual and prior observations vary by series and reference period.
curl --fail-with-body \
"https://www.financecalendar.com/wp-json/fc/v1/next?series=us-gdp" \
-H "X-API-Key: $FC_API_KEY"Keep your API key in private server configuration. Data requests share your account allowance.
Forecasts and results
Paid plans add release forecasts for 60 headline measures across 10 economies in the forecasts field, refreshed hourly, frozen at release time and labelled with their update time and source count. Build richer release briefings and dashboards with provider consensus forecasts across 12 selected US headline release series: US headline CPI, nonfarm payrolls, PPI, retail sales, PCE, ISM Manufacturing, industrial production, Conference Board Consumer Confidence, JOLTS, ADP employment, ISM Services PMI and goods-and-services Trade Balance. Compare recorded forecasts with published results on covered releases, alongside dates, impact ratings and source links.
Actual and prior values combine validated official observations with matched provider data. Each value retains its metric, reference period and source evidence. Review coverage and source evidence or query /quality for the current records; a value without recorded evidence remains null. The public calendar is free to browse; programmatic access uses a paid API plan.
Historical response examples: the examples below illustrate the response structure. Query the authenticated endpoints for current forecasts and results; recorded history represents the captured vintage.
The GDP figures, series filters and wider-date examples below use paid API access. Free Developer is a bounded schedule preview, not a numerical or historical data feed.
Authentication and account allowances
Account and API key required
Use a verified account key for authenticated data requests, in X-API-Key or Authorization: Bearer. Choose Free Developer for its bounded schedule JSON or a paid plan for numerical figures, wider dates, richer routes and tools. The OpenAPI schema, current product offer and fixed recorded sample are public without a key. Create and manage keys in your account; anonymous key creation is not supported.
Authentication and account allowances
Browse the public economic calendar free. Connect apps and AI tools with paid API access from US$4.99/month or US$53.89/year. Starter includes 250 requests per UTC day and 5,000 per UTC calendar month. Build is US$9.99/month or US$95.90/year, with 100,000 requests per UTC day. Scale is US$29.00/month or US$278.40/year, with 1,000,000 requests per UTC day and the complete current dataset download. Free Developer provides 100 successful schedule JSON responses per UTC calendar month, up to 10 per UTC day, with one key issued after approval of your request (allow up to 168 hours for review). Use /calendar and /today for economic-release and central-bank schedules from UTC today through today+6, with country/impact filters, bounded date narrowing and up to 20 records per response. The allowance renews monthly; no card, fixed expiry or automatic paid subscription. Figures, history, wider dates/routes, CSV/ICS, hosted MCP, Data explorer and webhooks require a paid plan. Personal and customer-facing projects are allowed within these limits and applicable source terms. Annual prices are charged upfront. Paid plans renew at their selected interval until cancelled; applicable tax is included. Linked keys share one account allowance.
Inspect the recorded sample · Compare current plans. Existing subscription agreements and paid-through migration access retain their confirmed terms.
Keep keys in private server or application configuration. Do not put them in public HTML, client JavaScript, spreadsheet cells, iframe URLs or query strings. For the shell examples below, enter your real key privately:
read -r -s FC_API_KEY
export FC_API_KEY
Missing or invalid credentials return 401; revoked or disallowed access returns 403; exhausted allowance returns 429. Key validation or data unavailability can return 503. Respect Retry-After when supplied. Credentialed responses are private/no-store; do not treat them as public CDN content. Retain Finance Calendar attribution and each record’s source rights.
GDP is 5 series in the Finance Calendar API. The generic alias gdp means the US release from the Bureau of Economic Analysis. The US schedule, with the advance, second and third estimates explained, is on the US GDP report hub.
Series codes
| Country | Code | Aliases | Publisher | Unit |
|---|---|---|---|---|
| United States | us-gdp |
gdp | Bureau of Economic Analysis | % q/q annualised |
| United Kingdom | gb-gdp |
uk-gdp | Office for National Statistics | % m/m |
| Euro area (flash) | eu-gdp |
eurozone-gdp, ea-gdp | Eurostat | % q/q |
| China | cn-gdp |
china-gdp | National Bureau of Statistics | % y/y |
| Japan | jp-gdp |
japan-gdp | Cabinet Office | % q/q annualised |
The unit field matters for GDP more than for most series. The US and Japan report an annualised quarter-on-quarter rate, the euro area a plain quarter-on-quarter rate, China a year-on-year rate, and the UK publishes a monthly figure with the quarterly estimate attached. Read unit before you compare countries.
Next release
UK GDP:
curl -H "X-API-Key: $FC_API_KEY" "https://www.financecalendar.com/wp-json/fc/v1/next?series=uk-gdp"
{
"series": "uk-gdp",
"series_code": "gb-gdp",
"country": "GB",
"next": {
"id": "uk-gdp-november-2026",
"series_code": "gb-gdp",
"series_name": "UK GDP",
"name": "UK GDP",
"title": "UK GDP November 2026",
"country": "GB",
"category": "economic-indicators",
"impact": "high",
"date": "2026-11-12",
"release_at_utc": "2026-11-12T07:00:00+00:00",
"time_utc": "2026-11-12T07:00:00+00:00",
"time_et": "02:00",
"release_tz": "Europe/London",
"all_day": false,
"period": "September 2026 (monthly) + Q3 2026 first quarterly estimate",
"status": "confirmed",
"consensus": null,
"prior": "0.4% QoQ (Q2 2026, published August 13, 2026)",
"actual": null,
"unit": "% m/m",
"source_url": "https://www.ons.gov.uk/releasecalendar",
"source_name": "Office for National Statistics",
"url": "https://www.financecalendar.com/event/uk-gdp-november-2026/",
"exchange": null,
"holiday_status": null,
"close_time_local": null,
"updated_at": "2026-10-19T16:02:05+00:00",
"note": "Covers September 2026 (monthly) + Q3 2026 first quarterly estimate"
},
"attribution": { "source": "financecalendar.com", "terms": "...", "docs": "..." }
}
The period field identifies the reference period where recorded. US GDP has advance, second and third estimates; use the recorded release stage and source context to distinguish them. Numerical observations are current recorded vintages for supported metrics, rather than a guaranteed archive of each original estimate.
The next US rows in the snapshot are 29 October, 25 November and 23 December 2026, all at 08:30 Eastern. China’s GDP is quarterly; /series/cn-gdp gives its next date (17 January 2027 at the time of writing).
Every GDP release in one call
curl -H "X-API-Key: $FC_API_KEY" "https://www.financecalendar.com/wp-json/fc/v1/calendar?series=us-gdp,gb-gdp,eu-gdp,cn-gdp,jp-gdp&to=2027-01-19"
Add format=ics to subscribe in a calendar app, or format=csv for a spreadsheet. Each row’s period and unit columns are included in the CSV.
Past releases
curl -H "X-API-Key: $FC_API_KEY" "https://www.financecalendar.com/wp-json/fc/v1/history?series=us-gdp&limit=8"
Returns up to 8 recorded US GDP releases newest first. Supported official metric and reference-period observations can populate actual and prior; they may remain null. consensus remains null. Historical rows are not a point-in-time first-print dataset.
Research economic growth
Add historical UK and Canadian monthly GDP observations to a research view. Check each measure’s units, source and dates; current recorded values can include revisions. These monthly measures are distinct from US quarterly GDP releases.
If there is no upcoming date
Between the publication of one year’s release schedule and the next, a series can briefly have no confirmed future date in the snapshot. /next then returns HTTP 404 with the message No upcoming event found for series "gdp". See /series for every code. rather than inventing a date. /series/us-gdp still returns the metadata and history, and next_date in /series is null until the publisher’s calendar is read. Dates that come from a rule rather than a published calendar carry status: estimated.
Frequently asked questions
What time is US GDP released?
08:30 Eastern Time, the same slot as CPI and the jobs report. The API gives the matching UTC instant in time_utc.
Which US estimate does the API track?
The schedule can contain advance, second and third estimates of US GDP. Inspect the recorded period, release_stage and source fields. A scheduled estimate does not establish that its original numerical result was captured.
Why is UK GDP monthly?
The ONS publishes a monthly GDP estimate; the first quarterly estimate is attached to the release that completes the quarter. The API’s period shows both when that happens.
Can I get GDP for other countries?
Not yet. The API covers the 5 above. /countries lists what each country has, and the changelog records additions.
Attribution
The public calendar is free to browse. API access requires an active paid subscription. Starter, Build and Scale all include API access for your own tools, apps and products. Retain a visible FinanceCalendar.com link and the source credits and rights notices supplied with each record. See the API service terms. Earnings dates are not included.
Build with the calendar behind the data.
Choose a plan, confirm your account and create an API key. Check the source coverage for the records your workflow needs.