Live release feed
Sub-second macro releases for FX backtests
Point-in-time history
Official CPI, jobs, GDP, and central-bank events with point-in-time history.
$25/month 14-day free trial
Start Free Trial

Release alerts

Get CAD Part-Time Employment alerts

Enter an email. We will notify you when the next official-source CAD Part-Time Employment release is published.

No account required. Unsubscribe anytime.

Back to API Index

Part-Time Employment (CAD)

Number of persons employed part-time.

History starts 2021-06-30 5.0 years currently available See coverage manifest
Latest reading: 3170800.0 Persons · Last updated: · Source: Statistics Canada

Category: Labor Market

API Endpoint

/api/v1/announcements/cad/part_time_employment

Use the production OpenAPI schema for the authoritative REST route metadata.

https://fxmacrodata.com/api/openapi.json

Browse the full endpoint reference

Open the public Part-Time Employment page →

Open the CAD docs hub →

Open the Part-Time Employment docs hub →

Compare Part-Time Employment across all supported currencies →

Optional Indicator Availability (CAD)

Optional indicators use per-currency fetcher capability checks and may be temporarily hidden while source coverage is being remediated.

foreign_reserves
Unavailable Temporarily hidden for this currency in the API catalogue.
cb_assets
Unavailable Temporarily hidden for this currency in the API catalogue.
inflation_mom
Unavailable Temporarily hidden for this currency in the API catalogue.

About Part-Time Employment (CAD)

Part-time employment for Canada counts workers employed fewer than 35 hours per week, including both voluntary part-time and involuntary (underemployment). Involuntary part-time work is a key slack indicator.

Why FX traders watch it

High involuntary part-time employment signals hidden labour market slack that can dampen wage growth even when headline unemployment is low, an important nuance for the Bank of Canada's assessment of economic capacity.

How to interpret the data

Rising involuntary part-time employment during an expansion is a dovish signal; it indicates more workers want full-time jobs, limiting wage pressure. Falling part-time counts alongside rising full-time employment is the most bullish combination for the cad.

Historical Part-Time Employment (CAD)

Source: Statistics Canada  ·  Monthly  ·  Persons  ·  History starts 2021-06-30

Data provided by FXMacroData via the /api/v1/announcements/cad/part_time_employment endpoint. For access, see pricing.

Endpoint coverage and contract

This page documents the exact request inputs, response fields, access model, and currently published history window for /api/v1/announcements/cad/part_time_employment.

Coverage window

Currently documented history runs from 2021-06-30 to 2016-07-31 for this endpoint.

History start

2021-06-30

Latest documented date

2016-07-31

Cadence

Monthly

Unit

Persons

Data Source

Primary Source

Statistics Canada

Official Series ID

Data Format and Properties

Data Frequency

Monthly

Unit of Measure

Persons

JSON Response Structure

The endpoint returns a chronological list of observations in JSON format, plus pagination metadata so larger series can be fetched page by page. 

{
  "currency": "CAD",
  "indicator": "part_time_employment",
  "has_official_forecast": false,
  "requested_start_date": "2021-06-30",
  "requested_end_date": "2016-07-31",
  "requested_window_has_data": true,
  "page_includes_latest_available": true,
  "start_date": "2021-06-30",
  "end_date": "2016-07-31",
  "earliest_available_date": "2021-06-30",
  "latest_available_date": "2016-07-31",
  "pagination": {
    "limit": 20,
    "offset": 0,
    "returned_count": 1,
    "total_count": 1,
    "has_more": false,
    "next_offset": null,
    "page_includes_latest_available": true
  },
  "cb_target": null,
  "source": "Statistics Canada",
  "source_url": "",
  "source_series_name": null,
  "source_local_name": null,
  "provenance": {
    "publisher": "Statistics Canada",
    "publisher_url": null,
    "storage": "FXMacroData Firestore",
    "served_by": "FXMacroData API",
    "timestamp_field": "announcement_datetime",
    "value_field": "val"
  },
  "data_quality": {
    "is_official": true,
    "is_proxy": false,
    "is_fallback": false,
    "is_stale": false,
    "has_announcement_datetime": true,
    "point_in_time_safe": true,
    "latest_available_date": "2016-07-31",
    "last_updated": null,
    "data_lag_days": null,
    "source_name": "Statistics Canada",
    "source_type": "official",
    "is_derived": false,
    "row_count": 1,
    "announcement_datetime_count": 1,
    "missing_announcement_datetime_count": 0,
    "quality_scope": "full_result",
    "stale_after_days": null,
    "requested_window_has_data": true,
    "page_includes_latest_available": true
  },
  "data": [
    {
      "date": "2016-07-31",
      "announcement_id": "cad_part_time_employment_2016-07-31",
      "val": 4.2,
      "announcement_datetime": 1722456000,
      "pct_change": null,
      "pct_change_12m": null
    }
  ]
}

Request Parameters & Usage

Access and authentication

USD is free without a key. All other currencies require a Professional API key.

Public USD endpoint — anonymous callers receive the most recent 365 days. Add `?api_key=YOUR_API_KEY` to page through full stored USD history or to access any other currency. Date filters are applied before pagination. The default page size is 20 rows and the maximum is 100. Use either `page` or `offset`; when both are provided, `page` takes precedence. Broad windows should be traversed with `pagination.next_offset`, not split into custom shorter-window retries. If the selected series exists but a requested date window has no observations, the API returns a structured `NO_DATA_IN_REQUESTED_WINDOW` 404 with coverage dates, `recommended_start_date`, and `available_observation_count`. Forecasts are served separately by /v1/predictions/cad; join via `announcement_id`.

Data source and provenance

Macroeconomic announcement and catalogue rows are normalized from official central-bank, national statistics, treasury, or government publisher releases. Responses expose publisher metadata via source, source_url, and provenance fields where available.

Responses expose source, source_url, and provenance fields so consumers can cite the upstream publisher and FXMacroData serving path. They also expose data_quality for standardized source type, fallback/proxy, stale-data, timestamp-completeness, and point-in-time safety flags.

Path parameters

Parameter Required Type Description
currency YES string 3-letter currency code.
indicator YES string Indicator slug. Use /v1/data_catalogue/{currency} to list available slugs per currency.

Query parameters

Parameter Required Format Description
start_date NO string (YYYY-MM-DD) Earliest observation date to include. Date filters are applied before pagination. Authenticated requests page through full stored history when omitted; anonymous USD requests are limited to the most recent 365 days.
end_date NO string (YYYY-MM-DD) Latest observation date to include. Defaults to today.
limit NO integer Maximum number of most-recent-first rows to return per page. Defaults to 20; maximum 100.
page NO integer One-based page number. When supplied, page takes precedence over offset; page=2 with limit=20 is equivalent to offset=20.
offset NO integer Zero-based row offset after date filtering. Use with pagination.next_offset to request the next page.
api_key Pro (USD: free for last 365 days) string Professional API key. Required for non-USD currencies and for USD requests that need history older than 365 days.

Pagination behavior

Use start_date and end_date to narrow the series first, then page through the filtered result with limit plus either page or offset. The default page size is 20 rows and the maximum is 100. page is one-based; offset is zero-based, and page takes precedence when both are supplied. Authenticated announcement requests without start_date page through the full stored history; anonymous USD requests are limited to the freemium window. The response includes earliest_available_date and latest_available_date for the series coverage inside the requested date window, plus a pagination object with returned_count, total_count, has_more, next_offset, and page_includes_latest_available. Broad windows are handled with pagination; use pagination.next_offset for the next request instead of splitting the range into shorter custom retries. If the selected series exists but the requested date window has no rows, the endpoint returns 404 with error_code=NO_DATA_IN_REQUESTED_WINDOW, coverage dates, recommended_start_date, and available_observation_count.

Response fields

Field Type Description
currency string 3-letter currency code.
indicator string Indicator slug as requested.
has_official_forecast boolean True if the central bank publishes an official forecast for this indicator.
start_date string Earliest date in the filtered result set (YYYY-MM-DD).
end_date string Latest date in the filtered result set (YYYY-MM-DD).
earliest_available_date string | null Earliest date available for this series before any date filter or pagination is applied.
latest_available_date string | null Latest date available for this series before pagination is applied.
requested_start_date string Start date applied to the request after endpoint defaults are resolved.
requested_end_date string End date applied to the request after endpoint defaults are resolved.
requested_window_has_data boolean False when the endpoint returned the latest eligible observation before the requested window instead of an observation inside the requested date range.
page_includes_latest_available boolean True when the current page includes latest_available_date. False usually means the latest row is on a different page or the response is a historical page.
pagination.limit integer Page size used for this response.
pagination.offset integer Zero-based offset used for this response.
pagination.returned_count integer Number of rows included in data[].
pagination.total_count integer Total number of rows matching the path and date filters before pagination.
pagination.has_more boolean True when another page is available.
pagination.next_offset integer | null Offset to use for the next page, or null when there are no more rows.
pagination.page_includes_latest_available boolean Mirrors page_includes_latest_available inside the pagination envelope for clients that keep pagination state together.
cb_target object | null Central bank target metadata (e.g. inflation target range), if applicable.
data[].date string Observation date (YYYY-MM-DD).
data[].announcement_id string Stable announcement identifier in the form `{currency}_{indicator}_{date}` — use it to join predictions from /v1/predictions/{currency} and revision history.
data[].val number | null Observed value in the indicator's native unit.
data[].announcement_datetime integer | null Unix timestamp (UTC) of the official data release.
data[].pct_change number | null Period-over-period percentage change.
data[].pct_change_12m number | null 12-month rolling percentage change.
data_quality object Standardized endpoint-level quality, source, freshness, and point-in-time safety metadata for the returned payload.
data_quality.is_official boolean True when the response is backed by an official source and is not proxy, fallback, derived, or prohibited-source data.
data_quality.is_proxy boolean True when the response is an explicit proxy for the requested concept rather than the primary official series.
data_quality.is_fallback boolean True when one or more returned rows are marked as fallback data.
data_quality.is_stale boolean True when the newest available observation is older than the endpoint's frequency-aware stale_after_days threshold.
data_quality.has_announcement_datetime boolean True when all rows in the quality scope carry the required announcement timestamp field or fields.
data_quality.point_in_time_safe boolean True when the result is not fallback/prohibited data and has complete release timestamps for point-in-time workflows.
data_quality.latest_available_date string | null Freshest observation date available for the quality scope before pagination-specific caveats.
data_quality.last_updated string | null Server-side refresh or update timestamp when the endpoint has one available.
data_quality.data_lag_days integer | null Calendar-day lag between today and latest_available_date; null when the latest date is missing, invalid, or future-dated.
data_quality.source_name string | null Human-readable source or publisher label used for the response.
data_quality.source_type official | public | fallback | derived Normalized source classification shared across source-backed REST and MCP responses.
data_quality.is_derived boolean True when the endpoint output is calculated from underlying source rows, such as spreads, slopes, forward curves, forecasts, or sentiment composites.
data_quality.row_count integer Number of rows considered in the data-quality scope.
data_quality.announcement_datetime_count integer Number of rows in scope with complete required announcement timestamp fields.
data_quality.missing_announcement_datetime_count integer Number of rows in scope missing at least one required announcement timestamp field.
data_quality.quality_scope string Scope used to compute the quality object, such as full_result, latest, recent, or scheduled_releases.
data_quality.stale_after_days integer | null Frequency-aware threshold used for is_stale; daily=7, weekly=21, monthly=62, quarterly=125, annual=550 by default.
source string Human-readable upstream publisher or source family for this response.
source_url string | null Official publisher URL or source landing page when available.
provenance object Structured provenance metadata including publisher, storage layer, served_by, timestamp field, and value field.
source_series_name string | null Publisher's source-series label when FXMacroData stores one.
source_local_name string | null Local-language or publisher-native series name when available.
provenance.publisher string Official upstream publisher for the requested currency/indicator series.
provenance.storage string FXMacroData serving storage layer, typically FXMacroData Firestore.

Example Usage

To retrieve the first page of Part-Time Employment data for CAD from 2023: 

GET https://fxmacrodata.com/api/v1/announcements/cad/part_time_employment?start_date=2023-01-01&end_date=2023-12-31&limit=20&page=1&api_key=YOUR_API_KEY

Frequently Asked Questions

How often is Canada Part-Time Employment updated?
Part-Time Employment for Canada is released on a monthly schedule by Bank of Canada (or the relevant national statistics agency). FXMacroData ingests each new value within seconds of the official publication and exposes the exact announcement timestamp on every record.
What unit is Part-Time Employment reported in?
The series is published in Persons. The exact unit is also returned on every API response under the indicator metadata.
Where does FXMacroData source Canada Part-Time Employment data?
Data is fetched directly from Bank of Canada or the official national statistics publication for Canada. The source URL is preserved on every announcement record so downstream consumers can trace the value back to its primary release.
How do I query Part-Time Employment for Canada via the API?
Issue a GET request to /api/v1/announcements/cad/part_time_employment?api_key=YOUR_API_KEY. The response contains a chronological list of observations with values, release dates, and announcement timestamps. USD announcement data is public; other currencies require a Professional API key.

Summarize article with AI:

ChatGPT Perplexity Claude Grok Gemini Mistral

AI Answer-Ready

Key Facts

Page
Part Time Employment
Section
API Data Docs
Canonical URL
https://fxmacrodata.com/api-data-docs/cad/part_time_employment
Source
Statistics Canada
Last Updated
2016-07-31

Provenance And Trust

Cite the canonical URL and source field above. Where available, this page maps to official publisher releases and timestamped updates.

What Changed

Latest change vs prior release: -301,200.0000 (-8.68%)

Quick Q&A

What is this page about? This page explains Part Time Employment with directly usable context for trading, research, and API workflows.

What source should be cited? Use the canonical URL and the listed source field; cite official publisher references when available.

How fresh is this content? The last updated value above reflects the page metadata or latest available data timestamp.

Can this be used in AI assistants? Yes. This section is intentionally structured for retrieval and citation in chat assistants.

Prompt Packs

Use these in ChatGPT, Claude, Gemini, Mistral, Perplexity, or Grok for consistent source-aware outputs.

Share page X LinkedIn Email