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

# List formats

`GET /formats`

## Request

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

List the video formats a generation can be built from, and the render styles they can be drawn in.

## Query parameters

- `page` integer

## Response `200`

List formats

- object
  - `formats` object[], required
    - `id` string, required
    - `key` string, required
    - `name` string, required
    - `description` string, nullable
    - `category` string, nullable
    - `render_style_key` string, nullable
    - `credit_multiplier` number, required
    - `actor_required` boolean
    - `product_required` boolean
    - `product_forbidden` boolean
  - `render_styles` object[], required
    - `id` string, required
    - `key` string, required
    - `name` string, required
    - `category` string, nullable
    - `default` boolean
  - `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)