Jobs report release dates API
Bring US jobs-report release dates, provider consensus forecasts and published actual/prior values into your dashboard or analysis. The expanded NFP data uses the monthly change in total nonfarm payroll employment, seasonally adjusted, with source evidence and reference periods for meaningful comparisons. The same API also contains selected UK, Canadian and Australian labour schedules, ADP, JOLTS and weekly jobless claims, with UTC and display times.
curl --fail-with-body \
"https://www.financecalendar.com/wp-json/fc/v1/next?series=nfp" \
-H "X-API-Key: $FC_API_KEY"Keep your API key in private server configuration. Data requests share your account allowance.
Expanded forecasts and results
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 NFP figures, series filters and richer examples below use paid API access. Free Developer returns bounded economic-release and central-bank schedule metadata, without the numerical result fields.
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$9.99/year. Starter includes 1,000 requests per UTC day and 25,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 after email verification. 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.
Non-farm payrolls is series code us-nfp in the Finance Calendar API. The aliases nfp, jobs, payrolls, non-farm-payrolls, jobs-report and employment all resolve to it. The schedule and what each report contains are on the US jobs report hub.
Next jobs report
curl -H "X-API-Key: $FC_API_KEY" "https://www.financecalendar.com/wp-json/fc/v1/next?series=nfp"
Recorded US NFP history response (selected fields)
This separate history request retrieves the November US jobs release. The /next query above continues to return the next scheduled release.
curl -H "X-API-Key: $FC_API_KEY" "https://www.financecalendar.com/wp-json/fc/v1/history?series=us-nfp&from=2026-11-06&to=2026-11-06&limit=1"
Recorded API response, checked 10 November 2026: selected fields from the NFP event in the history events array.
{
"id": "us-employment-situation-non-farm-payrolls-november-2026",
"series_code": "us-nfp",
"date": "2026-11-06",
"release_at_utc": "2026-11-06T13:30:00+00:00",
"unit": "jobs",
"consensus": "65000",
"actual": "165000",
"prior": "60000",
"source_url": "https://www.bls.gov/news.release/empsit.nr0.htm"
}
The report is released at 08:30 Eastern on the first Friday of the month in most months. The November 2026 report falls on 6 November, after the US clock change, so time_utc is 13:30 rather than the 12:30 of the summer months. Use time_utc and you never have to think about it.
The actual, prior and consensus fields bring results and recorded expectations together for covered US nonfarm payroll releases. Values use an exact metric and reference-period match; validated official observations take precedence where available. Other labour series retain their own schedules and numerical coverage. Query /quality or the coverage directory for current evidence.
Labour market series
| Series | Code | Aliases | Impact |
|---|---|---|---|
| US Employment Situation (NFP) | us-nfp |
nfp, jobs, payrolls, jobs-report, employment | high |
| US ADP Employment Report | us-adp |
adp, adp-employment | medium |
| US JOLTS Job Openings | us-jolts |
jolts, job-openings | medium |
| US Initial Jobless Claims (weekly) | us-jobless-claims |
jobless-claims, claims, initial-claims | medium |
| UK Labour Market Report | gb-jobs |
uk-jobs, uk-labour-market, uk-unemployment | high |
| Canada Labour Force Survey | ca-jobs |
canada-jobs, canada-labour-force | high |
| Australia Labour Force | au-jobs |
australia-jobs, australia-labour-force | high |
| Eurozone Unemployment | eu-unemployment |
eurozone-unemployment | medium |
The generic alias jobs means the US report. For another country use the prefix or country=:
curl -H "X-API-Key: $FC_API_KEY" "https://www.financecalendar.com/wp-json/fc/v1/next?series=uk-jobs"
curl -H "X-API-Key: $FC_API_KEY" "https://www.financecalendar.com/wp-json/fc/v1/next?series=jobs&country=ca"
The Canadian Labour Force Survey is published at 08:30 Eastern on the same morning as NFP in most months. The API returns both on 6 November 2026 at 13:30:00+00:00, so a dashboard that lists the day’s releases shows them side by side.
The whole jobs week
JOLTS, ADP, jobless claims and NFP usually fall in the same week. One call lists them in order:
curl -H "X-API-Key: $FC_API_KEY" "https://www.financecalendar.com/wp-json/fc/v1/calendar?series=us-jolts,us-adp,us-jobless-claims,us-nfp&to=2026-11-13&tz=America/New_York"
As a calendar subscription for the next 92 days:
https://www.financecalendar.com/wp-json/fc/v1/calendar?series=us-nfp,gb-jobs,ca-jobs,au-jobs&to=2027-01-19&format=ics
Past reports
curl -H "X-API-Key: $FC_API_KEY" "https://www.financecalendar.com/wp-json/fc/v1/history?series=us-nfp&limit=12"
Returns up to 12 recorded reports newest first, including recorded consensus, prior and actual values for covered US NFP releases. /series/us-nfp adds the series metadata, next recorded report and upcoming dates. Read the unit, reference period and source evidence with each result; values without recorded evidence remain null.
Frequently asked questions
What time is the jobs report released?
08:30 Eastern Time. That is 12:30 UTC during US daylight saving time and 13:30 UTC otherwise. Every row carries both time_et and time_utc.
Is it always the first Friday?
Usually, but not always. Holidays and the BLS survey schedule move it, which is why the API reads the BLS release calendar (linked in source_url) every hour rather than applying a rule. Dates that come from a rule carry status: estimated.
Can I get the unemployment rate as a number?
When available, actual represents the explicitly mapped official metric. Use unit, the reference period and the observations or release-metric fields to interpret it. Do not parse a combined article headline as if it were a guaranteed API result.
What about the ADP report?
Series us-adp, published on the Wednesday before the jobs report. It is in the same API with the same fields.
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.