---
title: "List media"
method: GET
path: "/media"
tags: ["media"]
---

# List media

`GET /media`

## Request

- Base URL: `https://www.socialfaktory.com/v1`
- URL: `https://www.socialfaktory.com/v1/media`
- Auth: HTTP bearer

Browse the finished exports in a brand media library, by folder or by name.

## Query parameters

- `brand_id` string: The brand this call belongs to. Required unless the token is pinned to a brand.
- `folder_id` string
- `query` string
- `kind` string
- `page` integer

## Response `200`

List media

- object
  - `media` object[], required
    - `id` string, required
    - `name` string, nullable
    - `kind` string, nullable
    - `aspect_ratio` string, nullable
    - `file_url` string, nullable
    - `pages` unknown[]
      - unknown
    - `created_at` string, required
  - `folders` object[], required
    - `id` string, required
    - `name` string, required
  - `page` integer, required
  - `pages` integer, required

## Other responses

- `default`: The error envelope

---

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