---
title: "Get Tool Job Rows"
method: GET
path: "/api/tool-jobs/{job_id}/rows"
tags: ["growth-artifact-jobs"]
---

# Get Tool Job Rows

`GET /api/tool-jobs/{job_id}/rows`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/tool-jobs/{job_id}/rows`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Path parameters

- `job_id` string, required

## Query parameters

- `offset` integer
- `limit` integer
- `after_row_index` integer, nullable
- `include_page_evidence` boolean

## Response `200`

Successful Response

- ToolJobRowsResponse
  - `artifact_id` string, nullable, required: Readable result artifact identity.
  - `finished` boolean, required: True after a durable terminal event exists.
  - `job_id` string, required: Durable job identity.
  - `limit` integer, required: Maximum rows requested for this page.
  - `next_offset` integer, nullable, required: Next offset, or null at the end.
  - `next_row_index` integer, nullable, required: Next immutable row index, or null at the end.
  - `offset` integer, required: Zero-based row offset used for this page.
  - `rows` ArtifactJobRow[], required: Rows in this bounded artifact page.
    - union: A tool-specific result row or another complete dynamic artifact row.
      - GeoClassificationResultRow: Geo fields appended to the caller's complete input row.
        - `geo_classification_error` string, required: Empty on success; bounded per-row failure detail otherwise.
        - `geo_classification_reason` string, required: Resolver explanation for the containment verdict.
        - `geo_credit_units` string, required: Exact nonnegative decimal customer-credit usage for this row.
        - `geo_resolved_level` 'metro' | 'city' | 'admin1' | 'country' | 'ambiguous' | 'unknown', required
      - AiAnalysisResultRow: Fixed audit fields plus every caller input and output_schema-defined field.
        - `ai_enrichment_error` string, required: Empty on success; bounded per-row provider or validation failure.
        - `model_used` string, required: Successful model, or the final attempted model when the row failed.
      - PlaceSearchResultRow: One normalized physical place with the query and rank that found it.
        - `address` string, required: Provider street or formatted address, or empty.
        - `category` string, required: Provider place category, or empty.
        - `city` string, required: Provider city, or empty when unavailable.
        - `country` string, required: Provider country code or name, or empty.
        - `google_maps_url` string, required: Provider map listing URL, or empty.
        - `lat` union, required: Observed latitude, including zero.
          - integer
          - number
        - `lng` union, required: Observed longitude, including zero.
          - integer
          - number
        - `name` string, required: Provider place or business name, or empty if absent.
        - `phone` string, required: Provider phone representation, or empty.
        - `place_id` string, required: Provider physical-place identity, or empty if absent.
        - `query` string, required: Exact normalized query that produced this row.
        - `rank` integer, required: One-based rank within the producing query.
        - `rating` union, required: Observed aggregate rating, including zero.
          - integer
          - number
        - `reviews_count` integer, nullable, required: Observed review count, including zero.
        - `state` string, required: Provider state or first-level region, or empty.
        - `website` string, required: Provider website URL, or empty.
      - PlaceReviewResultRow: One normalized review linked to the physical place requested by the caller.
        - `likes_count` integer, nullable, required: Observed helpful-like count, including zero.
        - `place_id` string, required: Physical-place identity this review belongs to.
        - `published_at` string, required: Provider publication timestamp or date representation, or empty.
        - `rating` union, required: Review rating, including zero.
          - integer
          - number
        - `response_text` string, required: Place-owner response text, or empty when unavailable.
        - `review_id` string, required: Provider review identity, or empty if absent.
        - `reviewer_name` string, required: Provider reviewer display name, or empty.
        - `text` string, required: Review text, or empty when unavailable.
      - ArtifactBusinessRow: Complete dynamic business row stored in the artifact.
  - `status` 'queued' | 'running' | 'blocked' | 'completed' | 'failed', required: Durable job lifecycle status.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)