---
title: "All IRCC forward-looking programs, current queue estimates, and application-month cohorts"
method: GET
path: "/api/v1/ircc-forward-looking.json"
---

# All IRCC forward-looking programs, current queue estimates, and application-month cohorts

`GET /api/v1/ircc-forward-looking.json`

## Request

- Base URL: `https://govwait.com`
- URL: `https://govwait.com/api/v1/ircc-forward-looking.json`
- Auth: none declared

Cohort months are the months applications were submitted within an IRCC snapshot. They are not historical publication dates.

## Response `200`

IRCC forward-looking collection

- ForwardCollection
  - `name` string, required
  - `description` string, required
  - `generated_at` string, required
  - `count` integer, required
  - `programs` ForwardProgram[], required
    - `entity_id` string, required
    - `jurisdiction` string, required: ISO 3166-1 alpha-2 of the government
    - `service_key` string, required
    - `service_name` string, required
    - `service_category` 'visa' | 'permit' | 'sponsorship' | 'refugee' | 'settlement' | 'passport'
    - `metric_type` 'published' | 'backward' | 'forward' | 'service_standard' | 'percentile', required: How to interpret the published measure. Forward projections must not be mixed with backward-looking recent-case statistics.
    - `applicant_country` string, nullable: ISO 3166-1 alpha-2; null for global service standards
    - `applicant_country_name` string, nullable
    - `source_collection_status` 'active' | 'source_unavailable', required: Whether GovWait can currently run its polite automated collector for the originating source
    - `source_collection_status_since` string, date, nullable, required: Date the non-active collection state began; null for active sources
    - `source_collection_status_note` string, nullable, required: Human-readable collection-state explanation; null for active sources
    - `source_last_verified_at` string, nullable, required: Last successful source verification by GovWait. This does not advance while collection is unavailable.
    - `latest` Observation, required
      - `value_raw` string, required: Verbatim official string, e.g. '31 days'
      - `value_days` number, nullable, required: Numeric duration. Calendar units are normalized to days (weeks x7, months x30.44). Official working-day figures preserve their working-day count; see unit_original. For a published range, this field uses the upper end while value_raw preserves the complete range. Null when no time is published.
      - `unit_original` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years' | 'working days' | 'null', nullable, required
      - `status` 'ok' | 'unavailable' | 'insufficient_data', required
      - `effective_date` string, date, required: The agency's own last-updated date when supplied; otherwise the date GovWait first observed this changed value
      - `retrieved_at` string, required: When we fetched it (ISO 8601)
      - `source_url` string, uri, required
      - `confidence` 'official'
    - `forward_looking` ForwardDetail, required
      - `snapshots` ForwardSnapshot[], required
        - `snapshot_date` string, date, required: IRCC's publication/update date for this projection snapshot
        - `retrieved_at` string, required
        - `source_url` string, uri, required
        - `current` ForwardValue, required
          - `cohort_month` string, date: Application submission month; present only for already-applied cohort rows
          - `wait_raw` string, required: Verbatim IRCC estimate
          - `wait_days` number, nullable, required: Normalized comparison value; qualifiers remain in wait_raw
          - `unit_original` 'days' | 'weeks' | 'months' | 'years' | 'null', nullable, required
          - `status` 'ok' | 'unavailable' | 'insufficient_data', required
          - `queue_raw` string, required: Verbatim approximate IRCC queue wording
          - `queue_people` integer, required: Approximate value or published upper threshold; consult queue_raw for the qualifier
          - `confidence` 'official', required
        - `cohorts` ForwardValue[], required
          - `cohort_month` string, date: Application submission month; present only for already-applied cohort rows
          - `wait_raw` string, required: Verbatim IRCC estimate
          - `wait_days` number, nullable, required: Normalized comparison value; qualifiers remain in wait_raw
          - `unit_original` 'days' | 'weeks' | 'months' | 'years' | 'null', nullable, required
          - `status` 'ok' | 'unavailable' | 'insufficient_data', required
          - `queue_raw` string, required: Verbatim approximate IRCC queue wording
          - `queue_people` integer, required: Approximate value or published upper threshold; consult queue_raw for the qualifier
          - `confidence` 'official', required
  - `license` string, required

---

[API](https://skmtc.dev/govwait/apis/govwait-api.md) · [All operations](https://skmtc.dev/govwait/apis/govwait-api/llms.txt) · [OpenAPI document](https://skmtc.dev/govwait/apis/govwait-api/revisions/63e51dffae13?raw)