---
title: "Read a job's result rows"
method: GET
path: "/v1/jobs/{id}/rows"
tags: ["Jobs"]
---

# Read a job's result rows

`GET /v1/jobs/{id}/rows`

## Request

- Base URL: `https://api.onegoodarea.com`
- URL: `https://api.onegoodarea.com/v1/jobs/{id}/rows`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

One row per input, in input order, 500 per page by default and at most 1000. Pass next_after from one page as after to read the next; rows written so far are readable while the job is still running.

## Path parameters

- `id` string, required

## Query parameters

- `after` integer
- `limit` integer

## Response `200`

Default Response

- object
  - `job_id` string, required
  - `rows` object[], required
    - `seq` integer, required
    - `input` string, required
    - `resolution` union, required
      - object
        - `status` 'resolved', required
        - `input` string, required
        - `place` object, required
          - `place_id` string, required
          - `place_type` 'country' | 'nation' | 'region' | 'district' | 'group' | 'neighbourhood', required
          - `name` string, required
          - `country` string, required
          - `nation` string, required
        - `resolved_via` object, required
          - `kind` 'place_id' | 'postcode' | 'code' | 'name', required
          - `scheme` 'iso3166-1' | 'iso3166-2' | 'ctry' | 'rgn' | 'lad' | 'msoa21' | 'iz2022' | 'lsoa21' | 'dz2022' | 'lsoa11' | 'dz2011' | 'iz2011', required
          - `value` string, required
        - `postcode` object, required
          - `postcode` string, required
          - `status` 'live' | 'terminated', required
          - `terminated_on` string, required
      - object
        - `status` 'ambiguous', required
        - `input` string, required
        - `candidates` object[], required
          - `label` string, required
          - `postcode` string, required
          - `place` object, required
            - `place_id` string, required
            - `place_type` 'country' | 'nation' | 'region' | 'district' | 'group' | 'neighbourhood', required
            - `name` string, required
            - `country` string, required
            - `nation` string, required
      - object
        - `status` 'not_found', required
        - `input` string, required
        - `reason` 'empty_input' | 'input_too_long' | 'invalid_input' | 'invalid_place_id' | 'unknown_place_id' | 'unknown_postcode' | 'unknown_code' | 'nation_not_covered' | 'name_not_found' | 'name_not_supported_in_batch', required
        - `message` string, required
    - `store_key` object, required
      - `scheme` 'iso3166-1' | 'iso3166-2' | 'ctry' | 'rgn' | 'lad' | 'msoa21' | 'iz2022' | 'lsoa21' | 'dz2022' | 'lsoa11' | 'dz2011' | 'iz2011', required
      - `code` string, required
    - `signals` object[], required
      - `key` string, required
      - `category` 'crime' | 'deprivation' | 'property' | 'schools' | 'amenities' | 'transport' | 'environment', required
      - `label` string, required
      - `value` union, required
        - number
        - string
      - `unit` string, required
      - `normalized_value` number
      - `percentile` number
      - `regional_percentile` number
      - `direction` 'higher_is_better' | 'lower_is_better' | 'neutral', required
      - `confidence` number, required
      - `confidence_reason` string, required
      - `source` string, required
      - `observed_period` string, required
      - `source_unavailable` true
      - `detail` object: Extra published figures behind `value`, for a deprivation domain.
        - `rank` number: The published rank within the nation (a tied rank is a published mid-rank such as 2790.5).
        - `score` number: The published score, where the publisher gives one (Scotland publishes none).
      - `period` object
        - `start` string, required
        - `end` string, required
      - `period_basis` 'reference' | 'load'
      - `released_at` string
      - `loaded_at` string, date-time
      - `retrieved_at` string, date-time
    - `signals_note` string, required
  - `next_after` integer, required
  - `meta` object, required
    - `engine_version` string, required
    - `generated_at` string, required

## Other responses

- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `429`: Default Response
- `500`: Default Response

---

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