---
title: "One route: latest value plus full recorded history"
method: GET
path: "/api/v1/entities/{entity_id}.json"
---

# One route: latest value plus full recorded history

`GET /api/v1/entities/{entity_id}.json`

## Request

- Base URL: `https://govwait.com`
- URL: `https://govwait.com/api/v1/entities/{entity_id}.json`
- Auth: none declared

## Path parameters

- `entity_id` string, required

## Response `200`

Entity document

- Entity
  - `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'
  - `history` 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
    - `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

## Other responses

- `404`: Unknown entity

---

[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)