---
title: "List Investigation Media"
method: GET
path: "/incidents/v1/investigations/{investigation_id}/media"
tags: ["Investigations"]
---

# List Investigation Media

`GET /incidents/v1/investigations/{investigation_id}/media`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/incidents/v1/investigations/{investigation_id}/media`
- Auth: HTTP bearer

## Path parameters

- `investigation_id` string, required

## Query parameters

- `sequence_id` string
- `page_size` integer, required
- `page_token` string
- `search` string
- `list_mode` 'InvestigationLinkListModeAll' | 'InvestigationLinkListModeDirectOnly'

## Response `200`

A successful response.

- S12IncidentsV1ListInvestigationMediaResponse
  - `media` S12IncidentsV1InvestigationMedia[]: the list of media
    - `uploaded_by` S12IncidentsV1UserMeta
      - `user_id` string: unique identifier for the user
      - `display_name` string: name of the user
      - `profile_image` S12CommonMedia
        - `id` string
        - `token` string
        - `filename` string: full file name, including file extension
        - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV': - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
      - `email` string: email address of the user
      - `seat_type` 'SUBSCRIPTION_SEAT_TYPE_UNSPECIFIED' | 'SUBSCRIPTION_SEAT_TYPE_PREMIUM' | 'SUBSCRIPTION_SEAT_TYPE_COLLABORATOR' | 'SUBSCRIPTION_SEAT_TYPE_LITE' | 'SUBSCRIPTION_SEAT_TYPE_SERVICE_USER' | 'SUBSCRIPTION_SEAT_TYPE_SUPPORT'
      - `status` 'USER_ACTIVE_STATUS_UNSPECIFIED' | 'USER_ACTIVE_STATUS_ACTIVE' | 'USER_ACTIVE_STATUS_DEACTIVATED': - USER_ACTIVE_STATUS_UNSPECIFIED: Status is unknown or not specified - USER_ACTIVE_STATUS_ACTIVE: User is active - USER_ACTIVE_STATUS_DEACTIVATED: User has been deactivated
      - `timezone` string: the timezone of the user
    - `uploaded_at` string, date-time: The time that the media was uploaded
    - `originates_from` S12IncidentsV1LinkOriginatesFrom
      - `linked_at` string, date-time: The time that the originating link was linked_at
      - `action` S12IncidentsV1InvestigationAction
        - `linked_at` string, date-time: The time that the action was linked at
        - `action` S12TasksV1Action
          - `task` S12TasksV1Task
            - `task_id` string: An ID uniquely identifying this task message. For example: 'aa70d8a6-af37-44f4-8768d8899fe274c5'
            - `creator` S12TasksV1TaskUser: The user associated to the task. They could be a creator or assignee.
              - …
            - `title` string: Title of this task
            - `description` string: Description of this task
            - `created_at` string, date-time: Date/time this task was created
            - `due_at` string, date-time: Date/time this task is due
            - `priority_id` string: Priority ID of this task
            - `status_id` string: Status ID of this task @deprecated. For task type of action use status instead. In use by task type of incident.
            - `collaborators` S12TasksV1TaskCollaborator[]: Collaborators of this task
              - …
            - `template_id` string: Template ID of the inspection the action belongs to
            - `inspection` S12TasksV1TaskInspection
              - …
            - `inspection_item` S12TasksV1TaskInspectionItem
              - …
            - `site` S12TasksV1TaskSite: The folder (site) data of this task.
              - …
            - `modified_at` string, date-time: Date/time this task was last modified
            - `references` S12TasksV1TaskReference[]: References on this task.
              - …
            - `completed_at` string, date-time: Date/time this task was completed at
            - `template_name` string: Template name of the inspection the action belongs to
            - `status` S12TasksV1TaskStatus
              - …
            - `asset_id` string: @deprecated Asset ID of this task
            - `asset` S12TasksV1TaskAsset
              - …
            - `action_label` S12TasksV1ActionLabel[]: Label of a task
              - …
            - `unique_id` string: The human readable unique ID of the task
            - `type` 'TASK_TYPE_ACTION' | 'TASK_TYPE_CUSTOM': - TASK_TYPE_ACTION: Indicates this task is of type Action. - TASK_TYPE_CUSTOM: Indicates this task is of a custom type.
            - `occurred_at` string, date-time: Date/time this task occurred at
            - `task_templates` S12TasksV1TaskTemplate[]: The list of templates linked to the action.
              - …
          - `custom_field_and_values` S12TasksV1TaskCustomFieldAndValue[]: Custom fields and their values (if any) belonging to the action
            - `field` S12TypefieldV1Field: Describes the values of a field.
              - …
            - `field_value` S12TypefieldV1FieldValue: Individual field value definition.
              - …
          - `type` S12TasksV1Type: The type associated with an action.
            - `type` 'TASK_TYPE_ACTION' | 'TASK_TYPE_CUSTOM': - TASK_TYPE_ACTION: Indicates this task is of type Action. - TASK_TYPE_CUSTOM: Indicates this task is of a custom type.
            - `id` string: The unique identifier of a type.
            - `name` string: The name of a type.
        - `is_access_denied` boolean: Flag to indicate that the requester does not have access to the linked action
        - `is_deleted` boolean: Flag to indicate that the linked action has been deleted
        - `originates_from` S12IncidentsV1LinkOriginatesFrom (recursive)
      - `issue` S12IncidentsV1InvestigationIssue
        - `linked_at` string, date-time: The time that the issue was linked at
        - `issue` S12TasksV1Incident: An Incident represents the details of an issue. This can include the category, any attached media, the location, any linked inspections and the task associated with the issue.
          - `task` S12TasksV1Task
            - `task_id` string: An ID uniquely identifying this task message. For example: 'aa70d8a6-af37-44f4-8768d8899fe274c5'
            - `creator` S12TasksV1TaskUser: The user associated to the task. They could be a creator or assignee.
              - …
            - `title` string: Title of this task
            - `description` string: Description of this task
            - `created_at` string, date-time: Date/time this task was created
            - `due_at` string, date-time: Date/time this task is due
            - `priority_id` string: Priority ID of this task
            - `status_id` string: Status ID of this task @deprecated. For task type of action use status instead. In use by task type of incident.
            - `collaborators` S12TasksV1TaskCollaborator[]: Collaborators of this task
              - …
            - `template_id` string: Template ID of the inspection the action belongs to
            - `inspection` S12TasksV1TaskInspection
              - …
            - `inspection_item` S12TasksV1TaskInspectionItem
              - …
            - `site` S12TasksV1TaskSite: The folder (site) data of this task.
              - …
            - `modified_at` string, date-time: Date/time this task was last modified
            - `references` S12TasksV1TaskReference[]: References on this task.
              - …
            - `completed_at` string, date-time: Date/time this task was completed at
            - `template_name` string: Template name of the inspection the action belongs to
            - `status` S12TasksV1TaskStatus
              - …
            - `asset_id` string: @deprecated Asset ID of this task
            - `asset` S12TasksV1TaskAsset
              - …
            - `action_label` S12TasksV1ActionLabel[]: Label of a task
              - …
            - `unique_id` string: The human readable unique ID of the task
            - `type` 'TASK_TYPE_ACTION' | 'TASK_TYPE_CUSTOM': - TASK_TYPE_ACTION: Indicates this task is of type Action. - TASK_TYPE_CUSTOM: Indicates this task is of a custom type.
            - `occurred_at` string, date-time: Date/time this task occurred at
            - `task_templates` S12TasksV1TaskTemplate[]: The list of templates linked to the action.
              - …
          - `category_id` string: @deprecated. Use category instead. The category id associated with the issue.
          - `category` S12TasksV1Category: A category is used to classify an issue. For example, you can filter issues by category for analytics, or give users or groups access to issues from a category.
            - `id` string: The UUID of a category.
            - `key` string: The name of a category. This can be a default name or one that is customized in your organization.
            - `label` string: The name of a category. This field's value is the same as the value for `key`.
            - `description` string: The description of a category.
            - `display_order` integer: The sorting order of a list of categories. This is unused, and is hardcoded as `0`.
            - `is_visible` boolean: The indicator for whether a category is visible or not for an organization on the web app and the mobile app.
            - `use_category_access_whitelist` boolean: The indicator for whether a category's issues can be accessed by anyone in your organization or not. If this is `false` for a category, then that category's issues can only be accessed by creators and assignees.
            - `items` S12TasksV1Item[]: List of all items to be used in the category
              - …
            - `notification_detail` 'CATEGORY_NOTIFICATION_DETAIL_UNSPECIFIED' | 'CATEGORY_NOTIFICATION_DETAIL_PRIVATE' | 'CATEGORY_NOTIFICATION_DETAIL_SUMMARY' | 'CATEGORY_NOTIFICATION_DETAIL_FULL': CategoryNotificationDetail represents the different level of detail for category notifications. - CATEGORY_NOTIFICATION_DETAIL_UNSPECIFIED: CATEGORY_NOTIFICATION_DETAIL_UNSPECIFIED is the default value and should not be used. - CATEGORY_NOTIFICATION_DETAIL_PRIVATE: CATEGORY_NOTIFICATION_DETAIL_PRIVATE notifications will be restricted to public metadata. - CATEGORY_NOTIFICATION_DETAIL_SUMMARY: CATEGORY_NOTIFICATION_DETAIL_SUMMARY notifications will include public and private metadata. - CATEGORY_NOTIFICATION_DETAIL_FULL: CATEGORY_NOTIFICATION_DETAIL_FULL will include all metadata and detailed responses.
            - `linked_template_ids` string[]: The list of template ids linked to this category.
            - `visibility_summary` S12TasksV1CategoryVisibilitySummary
              - …
            - `user_access_as_reporter` 'CATEGORY_USER_ACCESS_AS_REPORTER_UNSPECIFIED' | 'CATEGORY_USER_ACCESS_AS_REPORTER_ALWAYS' | 'CATEGORY_USER_ACCESS_AS_REPORTER_NEVER' | 'CATEGORY_USER_ACCESS_AS_REPORTER_WHEN_SITE_MEMBER'
          - `media` S12CommonMedia[]: Any media associated with this issue.
            - `id` string
            - `token` string
            - `filename` string: full file name, including file extension
            - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV': - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
          - `location` S12TasksV1TaskAddressLocation: The location of the task. The latitude and longitude in the `geo_position` object are required. All other fields are optional, but add extra context to the location on platform.
            - `name` string: The name of the task's location.
            - `thoroughfare` string: The thoroughfare of the location.
            - `sub_thoroughfare` string: The sub_thoroughfare of the location,
            - `locality` string: The locality of the location
            - `sub_locality` string: The sub_locality of the location
            - `administrative_area` string: The administrative_area of the location
            - `sub_administrative_area` string: The sub_administrative_area of the location
            - `postal_code` string: The postal_code of the location
            - `country` string: The country of the location
            - `iso_country_code` string: The iso_country_code of the location
            - `geo_position` S12CommonGeoPosition: A position is the fundamental geographical geometry construct.
              - …
          - `inspections` S12TasksV1Inspection[]: The inspections that are linked to this issue.
            - `id` string: The ID of the linked inspection. This may or may not be a UUID, so we don't validate it here.
            - `created_at` string, date-time: The date the inspection was created.
            - `status` 'INSPECTION_STATUS_UNSPECIFIED' | 'INSPECTION_STATUS_IN_PROGRESS' | 'INSPECTION_STATUS_COMPLETED' | 'INSPECTION_STATUS_DELETED': - INSPECTION_STATUS_UNSPECIFIED: The status of the inspection is unspecified - INSPECTION_STATUS_IN_PROGRESS: The status of the inspection is 'In Progress' - INSPECTION_STATUS_COMPLETED: The status of the inspection is 'Completed' - INSPECTION_STATUS_DELETED: The status of the inspection is 'Deleted'
            - `title` string: The title of the inspection
            - `template_title` string: The title of the template that this inspection was created from
          - `items` S12TasksV1Item[]: A snapshot of the category items, at the time of creation.
            - `id` string: The UUID of the item.
            - `name` string: Name of the item
            - `is_mandatory` boolean: Whether or not the item must be filled before submission
            - `type` 'ITEM_TYPE_UNSPECIFIED' | 'ITEM_TYPE_TITLE' | 'ITEM_TYPE_DESCRIPTION' | 'ITEM_TYPE_SITE' | 'ITEM_TYPE_MEDIA' | 'ITEM_TYPE_LOCATION' | 'ITEM_TYPE_QUESTION' | 'ITEM_TYPE_OCCURRED_AT' | 'ITEM_TYPE_ASSET': - ITEM_TYPE_UNSPECIFIED: The item type is unspecified
            - `question_data` S12TasksV1Question: Question represents the question structure for a custom question.
              - …
            - `is_disabled` boolean: Whether or not the item is disabled and hidden from submission
          - `question_answers` S12TasksV1QuestionAnswers[]: The answers to the snapshot category items
            - `question_id` string: The ID of the question
            - `answer_set` S12TasksV1Answer[]: The set of answers that is associated with the question.
              - …
          - `ai_generated` boolean: Use `ai_marking`. True when this issue was created via an AI-assisted flow. A plain boolean, so it cannot tell absent from false.
          - `ai_marking` S12CommonV1AiMarking: AiMarking carries the AI marking fact on an API representation, so a machine can read whether AI and whether a person produced or changed the content. It is the read side of the express path: one shared message with standard property names, rather than every domain inventing its own field for the same fact. Both fields are presence tracked. The three states each carry a different meaning and must not be collapsed: true The actor named by the field produced or changed this content. false The actor named by the field is known not to have produced or changed this content. It is a claim about that actor only. absent We did not record the origin. false is not evidence that a deterministic path produced the content. Known human only content can read ai_edited false, and known AI only content can read human_edited false. Set a field to false only when you know it is false. Leave it absent when you do not, so a consumer relying on the API for their own obligation can tell "not true" from "not recorded". EU AI Act Article 50(2), engineering approach page.
            - `ai_edited` boolean: True when something non deterministic, in practice an LLM, produced or changed this content. False when no AI did, which includes content a person wrote and content a deterministic path produced. Absent when the origin was not recorded. Do not report false in place of absent.
            - `human_edited` boolean: True when a person authored or changed this content. False when no person did, which includes content a model generated and content a deterministic path produced. Absent when the origin was not recorded. Do not report false in place of absent.
        - `is_access_denied` boolean: Flag to indicate that the requester does not have access to the linked issue
        - `is_deleted` boolean: Flag to indicate that the linked issue has been deleted
        - `originates_from` S12IncidentsV1LinkOriginatesFrom (recursive)
      - `inspection` S12IncidentsV1InvestigationInspection
        - `linked_at` string, date-time: The time that the inspection was linked at
        - `inspection` S12InspectionsV1GetInspectionsResponseInspectionsListItem
          - `id` string: inspections id
          - `name` string: title of the inspection
          - `completed` boolean: if the inspection is completed or not
          - `archived` boolean: if inspection is archived or not
          - `score_percentage` number, double: score percentage
          - `score` number, double: score of the inspection
          - `total_score` number, double: total score of the inspection
          - `duration` string, int64: total duration of the inspection
          - `document_number` string: document number of the inspection
          - `date_started` string, date-time: date the inspection started
          - `date_modified` string, date-time: date the inspection was last modified
          - `date_completed` string, date-time: date the inspection was completed. can be a zero date for incomplete inspections
          - `date_conducted` string, date-time: date the inspection was conducted
          - `revision_key` string: revision key of the inspection
          - `metadata_image` S12CommonMedia
            - `id` string
            - `token` string
            - `filename` string: full file name, including file extension
            - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV': - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
          - `template` S12InspectionsV1GetInspectionsResponseInspectionsListItemTemplate
            - `id` string: corresponding template id
            - `name` string: corresponding template name
          - `location` S12InspectionsV1GetInspectionsResponseInspectionsListItemLocation
            - `location_text` string: inspection location description
            - `location` S12CommonGeoPosition: A position is the fundamental geographical geometry construct.
              - …
          - `author` S12InspectionsV1GetInspectionsResponseInspectionsListItemAuthor
            - `id` string: user id of the author
            - `name` string: name of the author
          - `owner` S12InspectionsV1GetInspectionsResponseInspectionsListItemOwner
            - `id` string: user id of the owner
            - `name` string: name of the author
          - `access_level` 'ACCESS_LEVEL_UNKNOWN' | 'ACCESS_LEVEL_VIEW' | 'ACCESS_LEVEL_EDIT' | 'ACCESS_LEVEL_DELETE'
          - `inspection_approval_state` 'INSPECTION_APPROVAL_STATE_UNSPECIFIED' | 'INSPECTION_APPROVAL_STATE_NOT_REQUESTED' | 'INSPECTION_APPROVAL_STATE_REQUESTED' | 'INSPECTION_APPROVAL_STATE_APPROVED': - INSPECTION_APPROVAL_STATE_UNSPECIFIED: Inspection has no approval pages - INSPECTION_APPROVAL_STATE_NOT_REQUESTED: Inspection has at least one approval page, and approval hasn't been requested yet - INSPECTION_APPROVAL_STATE_REQUESTED: Approval has been requested for one of the pages - inspection is awaiting approval - INSPECTION_APPROVAL_STATE_APPROVED: All approval pages in the inspection has been approved
          - `date_approved` string, date-time: date the inspection was last approved
          - `last_approver` S12InspectionsV1GetInspectionsResponseInspectionsListItemApprover
            - `id` string: user id of the approver
            - `name` string: name of the approver
        - `is_access_denied` boolean: Flag to indicate that the requester does not have access to the linked inspection
        - `is_deleted` boolean: Flag to indicate that the linked inspection has been deleted
        - `originates_from` S12IncidentsV1LinkOriginatesFrom (recursive)
      - `media` S12IncidentsV1InvestigationMedia (recursive)
    - `file` S12CommonMedia
      - `id` string
      - `token` string
      - `filename` string: full file name, including file extension
      - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV': - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
    - `is_access_denied` boolean: Flag to indicate that the requester does not have access to the linked media
  - `next_page_token` string: A token which can be used to fetch further results

## Other responses

- `default`: An unexpected error response.

---

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