---
title: "Gets the results grid for a job."
method: GET
path: "/job/{jobId}/results"
tags: ["Job"]
---

# Gets the results grid for a job.

`GET /job/{jobId}/results`

Resolves the job's rapid type server-side and returns the matching result shape (rapid
 cards, ranking datapoints, or grouped rankings). Returns 404 when the job has no
 labelling task.

## Path parameters

- `jobId` string, required

## Query parameters

- `states` RapidState[]
- `page` integer
- `page_size` integer

## Response `200`

OK

- union — The unified job results payload, discriminated by the job's rapid type.
  - object — Results for a grouped-ranking job: a paged list of sub-rankings.
    - `_t` 'GroupedRankingResults', required
    - `total` integer, required — The total number of sub-rankings.
    - `page` integer, required — The 1-based page number.
    - `pageSize` integer, required — The page size.
    - `items` GroupedRankingGroup[], required — The sub-rankings on this page.
      - `id` string, required
      - `name` string, required
      - `state` string, required
      - `pairMakerInformation` union, required
        - object
          - `_t` 'FullPermutationPairMakerInformation', required
        - object
          - `_t` 'OnlinePairMakerInformation', required
          - `randomMatchesRatio` number, float, required
          - `totalComparisonBudget` integer, required
          - `currentComparisonBudget` integer, required
      - `datapoints` RankingDatapoint[], required
        - `datapointId` string, required
        - `asset` union, required
          - object
            - `_t` 'FileAsset', required
            - `fileName` string, required
            - `metadata` MetadataModelCollection, required
            - `identifier` string, required
          - object
            - `_t` 'MultiAsset', required
            - `assets` IAsset[], required
            - `metadata` MetadataModelCollection, required
            - `identifier` string, required
          - object
            - `_t` 'NullAsset', required
            - `metadata` MetadataModelCollection, required
            - `identifier` string, required
          - object
            - `_t` 'TextAsset', required
            - `text` string, required
            - `metadata` MetadataModelCollection, required
            - `identifier` string, required
        - `elo` integer, required
      - `totalVotes` integer, required
  - object — Results for a compare (ranking) job: a paged list of Elo-ranked datapoints.
    - `_t` 'RankingResults', required
    - `total` integer, required — The total number of datapoints.
    - `page` integer, required — The 1-based page number.
    - `pageSize` integer, required — The page size.
    - `totalVotes` integer, required — The total number of votes cast.
    - `items` RankingDatapoint[], required — The ranked datapoints on this page.
      - `datapointId` string, required
      - `asset` union, required
        - object
          - `_t` 'FileAsset', required
          - `fileName` string, required
          - `metadata` MetadataModelCollection, required
          - `identifier` string, required
        - object
          - `_t` 'MultiAsset', required
          - `assets` IAsset[], required
          - `metadata` MetadataModelCollection, required
          - `identifier` string, required
        - object
          - `_t` 'NullAsset', required
          - `metadata` MetadataModelCollection, required
          - `identifier` string, required
        - object
          - `_t` 'TextAsset', required
          - `text` string, required
          - `metadata` MetadataModelCollection, required
          - `identifier` string, required
      - `elo` integer, required
  - object — Results for a simple or evaluation job: a paged grid of per-rapid cards.
    - `_t` 'RapidResults', required
    - `total` integer, required — The total number of rapids.
    - `page` integer, required — The 1-based page number.
    - `pageSize` integer, required — The page size.
    - `items` JobRapidResult[], required — The rapid cards on this page.
      - `rapidId` string, required
      - `asset` union, required
        - object
          - `_t` 'FileAsset', required
          - `fileName` string, required
          - `metadata` MetadataModelCollection, required
          - `identifier` string, required
        - object
          - `_t` 'MultiAsset', required
          - `assets` IAsset[], required
          - `metadata` MetadataModelCollection, required
          - `identifier` string, required
        - object
          - `_t` 'NullAsset', required
          - `metadata` MetadataModelCollection, required
          - `identifier` string, required
        - object
          - `_t` 'TextAsset', required
          - `text` string, required
          - `metadata` MetadataModelCollection, required
          - `identifier` string, required
      - `responses` JobResponse[], required
        - `id` string, required
        - `userId` string, required
        - `country` string, required
        - `language` string, required
        - `age` string, nullable, required
        - `gender` string, nullable, required
        - `occupation` string, nullable, required
        - `result` union, required
          - object
            - `_t` 'AttachCategoryResult', required
            - `rapidId` string, required
            - `category` string, required
          - object
            - `_t` 'BoundingBoxResult', required
            - `rapidId` string, required
            - `boundingBoxes` BoundingBoxResultBox[], required
              - …
          - object
            - `_t` 'CompareResult', required
            - `rapidId` string, required
            - `winners` string[]
          - object
            - `_t` 'FreeTextResult', required
            - `rapidId` string, required
            - `answer` string, required
          - object
            - `_t` 'LineResult', required
            - `rapidId` string, required
            - `lines` LineResultLine[], required
              - …
          - object
            - `_t` 'LocateResult', required
            - `rapidId` string, required
            - `coordinates` LocateCoordinate[], required
              - …
          - object
            - `_t` 'NamedEntityResult', required
            - `rapidId` string, required
            - `classifications` NamedEntityResultNamedClassification[], required
              - …
          - object
            - `_t` 'PolygonResult', required
            - `rapidId` string, required
            - `shapes` PolygonResultShape[], required
              - …
          - object
            - `_t` 'ScrubResult', required
            - `rapidId` string, required
            - `timestamps` integer[], required
          - object
            - `_t` 'SkipResult', required
            - `rapidId` string, required
          - object
            - `_t` 'TranscriptionResult', required
            - `rapidId` string, required
            - `selectedWords` TranscriptionResultTranscriptionWord[], required
              - …
        - `userScore` number, double, required
        - `userScores` object, required
        - `demographicInformation` object, required
      - `totalResponseCount` integer, required
      - `state` 'Labeling' | 'Paused' | 'Incomplete' | 'Flagged' | 'Done' | 'None' | 'Rejected', required
      - `payload` union, required
        - object
          - `_t` 'BoundingBoxPayload', required
          - `target` string, required
        - object
          - `_t` 'ClassifyPayload', required
          - `categories` ClassifyPayloadCategory[], required
            - `label` string, required
            - `value` string, nullable
          - `title` string, required
        - object
          - `_t` 'ComparePayload', required
          - `criteria` string, required
        - object
          - `_t` 'FreeTextPayload', required
          - `question` string, required
          - `shouldValidateResponse` boolean
          - `validationSystemPrompt` string, nullable
        - object
          - `_t` 'LinePayload', required
          - `target` string, required
        - object
          - `_t` 'LocatePayload', required
          - `target` string, required
        - object
          - `_t` 'NamedEntityPayload', required
          - `target` string, required
          - `classes` string[], required
        - object
          - `_t` 'PolygonPayload', required
          - `target` string, required
        - object
          - `_t` 'ScrubPayload', required
          - `target` string, required
        - object
          - `_t` 'TranscriptionPayload', required
          - `title` string, required
          - `transcription` TranscriptionPayloadTranscriptionWord[], required
            - `word` string, required
            - `wordIndex` integer, required
      - `context` string, nullable
      - `contextAsset` union
        - IAssetFileAsset
          - `_t` 'FileAsset', required
          - `fileName` string, required
          - `metadata` MetadataModelCollection, required
          - `identifier` string, required
        - IAssetMultiAsset
          - `_t` 'MultiAsset', required
          - `assets` IAsset[], required
            - union
              - …
          - `metadata` MetadataModelCollection, required
          - `identifier` string, required
        - IAssetNullAsset
          - `_t` 'NullAsset', required
          - `metadata` MetadataModelCollection, required
          - `identifier` string, required
        - IAssetTextAsset
          - `_t` 'TextAsset', required
          - `text` string, required
          - `metadata` MetadataModelCollection, required
          - `identifier` string, required
      - `decisiveness` number, double, nullable
      - `aggregation` union
        - IResponseAggregationClassifyAggregation
          - `_t` 'ClassifyAggregation', required
          - `categoryTallies` object, required
        - IResponseAggregationCompareAggregation
          - `_t` 'CompareAggregation', required
          - `winnerTallies` object, required

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

---

[API](https://skmtc.net/rapidata/apis/rapidata-api.md) · [All operations](https://skmtc.net/rapidata/apis/rapidata-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rapidata/rapidata-api/revisions/5f993bd211f5/schema)