---
title: "List findings for a visit (Beta)"
method: GET
path: "/v1/visits/{visit_id}/findings"
tags: ["Visits"]
---

# List findings for a visit (Beta)

`GET /v1/visits/{visit_id}/findings`

## Request

- Base URL: `https://api.navigateai.co`
- URL: `https://api.navigateai.co/v1/visits/{visit_id}/findings`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/navigateai/apis/navigateai-api/docs/v1/visits/:visit_id/findings/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `visit_id` string, required

## Response `200`

OK

- ListFindingsResponse
  - `findings` FindingExternalSchema[], required
    - `question_id` string, nullable, required: ID of the checklist question this finding answers. It remains the same when the question is renamed or edited. Null when the finding is not tied to a checklist question.
    - `question_reference_key` string, nullable, required: Your external identifier for the checklist question this finding answers. Null when none is set or the finding is not tied to a checklist question.
    - `question_name` string, nullable, required: Name of the checklist question this finding answers. For a finding not tied to a checklist question, the name given to the finding.
    - `question_text` string, nullable, required: Full text of the checklist question this finding answers. Null when the finding is not tied to a checklist question.
    - `description` string, required: The reason or justification for this finding.
    - `result` string, required: The result of the finding (e.g. "Poor", "Fair").
    - `severity` 'major' | 'minor', nullable, required: Severity of the finding, if applicable: "major", "minor", or null.
    - `area_name` string, nullable, required: The room or area this finding applies to.
    - `evidence` union[], required: Supporting evidence — images, audio segments, or text notes.
      - union
        - ImageEvidenceExternalSchema
          - `type` 'image'
          - `image_id` string, required: Use with the Get Image endpoint to retrieve the image file.
          - `reference_key` string, nullable: For an image from Upload an image, the `reference_key` you sent. Images captured in the NavigateAI app can have a value that the app set.
          - `visit_id` string, nullable: The visit this image was captured during. Null for images from Upload an image.
          - `is_selected` boolean: Whether this image was explicitly selected as evidence.
          - `is_starred` boolean: Whether this image was starred as the primary evidence photo.
        - AudioEvidenceExternalSchema
          - `type` 'audio'
          - `start_ms` integer, required: Start timestamp in the source video, in milliseconds.
          - `end_ms` integer, required: End timestamp in the source video, in milliseconds.
          - `text` string, required: Transcribed text from this audio segment.
          - `visit_id` string, nullable: The visit this audio was recorded during. Null when the evidence item is not tied to a visit.
        - TextEvidenceExternalSchema
          - `type` 'text'
          - `text` string, required
          - `visit_id` string, nullable: The visit this text was recorded during. Null when the answer is not tied to a visit.

## Changes

- **2026-10-13** `f8ddf84a89a8`: 2 info
  - added the required property `findings/items/question_id` to the response with the `200` status
  - added the required property `findings/items/question_reference_key` to the response with the `200` status
- **2026-09-23** `d184e670d61f`: 2 info
  - added the optional property `findings/items/evidence/items/anyOf[subschema #2: AudioEvidence]/visit_id` to the response with the `200` status
  - added the optional property `findings/items/evidence/items/anyOf[subschema #3: TextEvidence]/visit_id` to the response with the `200` status

[Operation history](https://skmtc.dev/navigateai/apis/navigateai-api/changes/v1/visits/:visit_id/findings/get.md)

---

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