---
title: "Fetch a list of media for the form data."
method: GET
path: "/custom_form_data/media"
tags: ["Documents|Form data"]
---

# Fetch a list of media for the form data.

`GET /custom_form_data/media`

This endpoint allows you to fetch a list of media used in custom forms. You can filter the list of media e.g.
to recieve a list of media from only a specific form definition. When no filter is specified, the response will
contain all media from all custom forms up to a limit of 100 records. You are able to download the media with the
`mediaData` endpoint.

## Query parameters

- `filter[byIds][]` integer[]
- `filter[byProjectIds][]` integer[]
- `filter[byEmployeeIds][]` integer[]
- `filter[byTrackerIds][]` integer[]
- `filter[byBeaconIds][]` integer[]
- `filter[byText]` string
- `filter[byFormDefinitionIds][]` integer[]
- `filter[byExternalReference]` string
- `filter[byStatus]` string
- `filter[byOrderIds][]` integer[]
- `filter[byBounds]` string
- `fieldName` string
- `limit` integer
- `offset` integer

## Response `200`

Success Response:

- StandardCustomFormDataMediaResponse
  - `files` object[] — The found images.
    - `customFormDataId` integer — The internal id of the form data.
    - `filename` string — The filename of the image.
  - `offset` integer — Number of skipped records.
  - `totalCount` integer — Total number of available media files.

---

[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/869b05603541/schema)