---
title: "Fetch file list."
method: GET
path: "/file/fetch"
tags: ["Documents|File"]
---

# Fetch file list.

`GET /file/fetch`

Files in geoCapture are used in different areas of the application. They can be added to employees, vehicles,
projects, orders and tools. This endpoint allows you to list uploaded and added files in geoCapture. Not included
in this endpoint are custom forms. Please use the Custom Form endpoints for interacting with them. Also,
miamapo maps are not included. mimapo is a tool for creating sketches on maps. For more information,
please click on this link: <a href="https://miamapo.de/" target="_blank">miamapo</a>

If you want to download a file, you must use the `fetch_file` endpoint.

## Query parameters

- `filter[byIds][]` integer[]
- `filter[byExternalIds][]` string[]
- `filter[byTypeId][]` integer[]
- `filter[byTypeReferences][]` string[]
- `filter[ownerType]` string
- `filter[ownerId]` integer
- `filter[from]` string
- `filter[to]` string
- `offset` integer
- `limit` integer

## Response `200`

Success Response:

- StandardFileFetchResponse
  - `data` object[] — The list of files.
    - `id` integer — The internal id of the file.
    - `externalId` string — The external id of the file.
    - `subject` string — The subject of the file.
    - `description` string — The description of the file.
    - `type` string — The name of the file type.
    - `ownerType` string — The type of object which the file is assigned to VEHICLE, ORDER, PROJECT, TOOL, EMPLOYEE OR NONE
    - `ownerId` integer — The id of the object which the file is assigned to
    - `date` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd
    - `validTo` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd
    - `fileSize` integer — The size of the file in bytes.
    - `extension` string — The extension of the file.
  - `offset` integer — Number of skipped records.
  - `totalCount` integer — Total number of available files. (Only calculated if offset is 0)

---

[API](https://skmtc.net/geocapture/apis/geocapture-api.md) · [All operations](https://skmtc.net/geocapture/apis/geocapture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geocapture/geocapture-api/versions/15839b24c497/schema)