---
title: "List extraction results"
method: GET
path: "/projects/{project_id}/results/"
tags: ["Results"]
---

# List extraction results

`GET /projects/{project_id}/results/`

## Request

- Base URL: `https://api.parsewise.ai/api/v1`
- URL: `https://api.parsewise.ai/api/v1/projects/{project_id}/results/`
- Auth: API key in header `X-API-Key`

Paginated extraction results for the project, with optional
filtering, sorting, and search. Pass `include_sources=true` to also
receive the document `sources` cited by the results on the returned
page — computed per page, so they stay in sync with the current
pagination and filters.

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `agent_ids` string
- `consistent_sources_only` boolean
- `dimension_order` string
- `filter_inconsistent` boolean
- `filter_missing` boolean
- `filter_review_status` string
- `filters` string
- `include_dimension_values` boolean
- `include_sources` boolean
- `page` integer
- `page_size` integer
- `search` string
- `search_column` string
- `sort_by` string
- `sort_order` 'asc' | 'desc'

## Response `200`

- V1ResultsListResponse
  - `results` V1ResultsListRow[], required: Rows of the extraction result table on this page.
    - `id` string, uuid, required: Identifier of the atomic value this row represents. To fetch the full detail for the resolved value, use the `id` from `resolution_result` with `GET /results/{id}/`.
    - `agent_name` string, required: Name of the agent that produced this row.
    - `value_type` 'string' | 'list' | 'number' | 'bool' | 'date' | 'datetime', required: * `string` - string * `list` - list * `number` - number * `bool` - bool * `date` - date * `datetime` - datetime
    - `extraction_status` 'Pending' | 'Processed' | 'No Result', required
    - `resolution_result` V1RowResolutionResult, required: Resolved value and metadata for a row in the results list. Same shape as the `GET /results/{id}/` response minus `atomic_value_id`, `dimension_instances`, and `sources`.
      - `id` string, uuid, required: Stable identifier of the resolution result.
      - `result_name` string, required: Human-readable label for this result, typically a concatenation of its dimension values.
      - `agent_name` string, required: Name of the agent that produced this result.
      - `value` unknown, required
      - `resolution_status` 'Not resolved' | 'Requires attention' | 'Resolved' | 'Ignored' | 'No result', required: * `Not resolved` - Not resolved * `Requires attention` - Requires attention * `Resolved` - Resolved * `Ignored` - Ignored * `No result` - No result
      - `justification_for_resolution_status` string, nullable, required: AI-generated explanation of why this resolution status was chosen. Null when not applicable.
      - `references` object, required: Citation map keyed by `reference_id` (the same IDs referenced from `justification_for_resolution_status` and from extraction passages). Each value is a 2-element array `[document_name, document_page]`: `document_page` is the 1-based page number, or `null` for sources without pages (e.g. websites). Empty object `{}` when there are no citations.
      - `source_type` 'document' | 'web' | 'document_and_web' | 'derived', required: * `document` - document * `web` - web * `document_and_web` - document_and_web * `derived` - derived
      - `is_web_supplement` boolean, required: True when this result was supplemented with web search data rather than derived purely from uploaded documents.
      - `web_supplement` V1ResultWebSupplement
        - `text` string, required: Web-sourced supplementary text.
        - `sources` V1ResultWebSupplementSource[], required: Web pages cited for the supplement.
          - `url` string, uri, required: URL of the web source.
          - `title` string, required: Title of the web source.
      - `updated_by_email` string, email, nullable, required: Email of the last user to manually override this resolution, or null if never manually updated.
      - `created_at` string, date-time, required: When the resolution was first produced.
      - `updated_at` string, date-time, required: When the resolution was last updated.
      - `latest_review_status` union: Review verdict from the latest review. Null when no review has ever been recorded. * `none` - none * `positive` - positive * `negative` - negative
        - 'none' | 'positive' | 'negative': * `none` - none * `positive` - positive * `negative` - negative
        - unknown
      - `latest_review_comment` string: Free-text reviewer comment from the latest review. Empty string when no comment was given.
      - `latest_review_at` string, date-time, nullable: When the latest review was recorded. Null when no review has ever been recorded.
      - `latest_review_by` string, email, nullable: Email of the user who recorded the latest review. Null when unknown or no review exists.
    - `dimension_instances` V1ResultDimensionInstance[], required: Dimension instances this row is keyed by (one entry per dimension configured on the agent).
      - `id` string, uuid, required: Identifier of this dimension instance.
      - `dimension_id` string, uuid, required: Identifier of the dimension this instance belongs to.
      - `dimension_value` string, required: Value of the dimension (e.g. "EMEA", "2024").
      - `name` string, required: Name of the dimension (e.g. "Region").
      - `document_id` string, uuid, nullable: Identifier of the source document when this entry is the Document pseudo-dimension.
  - `count` integer, required: Number of rows returned on this page (i.e. the length of `results`). For the cross-page total, use `total_rows`.
  - `page` integer, required: 1-indexed page number of the returned page.
  - `page_size` integer, required: Requested page size (rows per page).
  - `total_pages` integer, required: Total number of pages available for the current filters.
  - `total_rows` integer, required: Total matching rows across all pages for the current filters.
  - `displayed_dimensions` string[], required: Ordered dimension names used to group/lay out rows in the response, reflecting the effective `dimension_order`.
  - `agent_ids` string[], required: Agents included in the response.
  - `recommended_dimension_order` string[], nullable: Suggested dimension ordering for multi-agent views, or null when no specific ordering is recommended.
  - `all_dimension_values` object: Map of dimension name to the full set of values seen for that dimension across the matching rows, useful for building filter pickers. Omitted when `include_dimension_values=false`.
  - `sources` V1ResultSource[]: Document pages cited by the results on this page. Only returned when `include_sources=true` is passed; always scoped to the results on the current page.
    - `document_name` string, required: Stored filename of the source document.
    - `page_number` integer, required: 1-indexed page number within the source document.
    - `document_id` string, uuid, required: Stable identifier of the source document.
    - `atomic_value_ids` string[], required: Identifiers of the atomic values whose resolutions cite this source.

---

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