---
title: "Retrieve a list of fonts"
method: GET
path: "/api/v1/fonts"
tags: ["Fonts"]
---

# Retrieve a list of fonts

`GET /api/v1/fonts`

## Request

- Base URL: `https://api.sudomock.com`
- URL: `https://api.sudomock.com/api/v1/fonts`
- Auth: API key in header `x-api-key`

List available fonts for text layers: the shared system catalog plus your own uploaded fonts. Supports search, category filtering, and pagination.

## Query parameters

- `page` integer: Page number (1-based)
- `per_page` integer: Results per page (1-100)
- `category` string: Filter by category, e.g. 'serif'
- `search` string: Filter by family name (case-insensitive contains)
- `scope` string: Which fonts to return: 'all' (system + yours), 'system', or 'custom' (yours only)

## Response `200`

Successful Response

- FontListResponse: List response wrapper for GET /api/v1/fonts.
  - `success` boolean: Always true on a successful response.
  - `data` FontResponse[], required: The fonts on this page.
    - `uuid` string, required: Font id
    - `family` string, required: Font family name, e.g. 'Open Sans'
    - `subfamily` string, nullable: Style within the family, e.g. 'Bold Italic'
    - `postscript_name` string, required: PostScript name, the stable key used to reference this font when rendering text layers
    - `category` string, nullable: Catalog category, e.g. 'sans-serif', 'serif', 'display'
    - `license` string, nullable: License identifier (system fonts)
    - `is_premium` boolean: Whether this is a premium catalog font
    - `is_system` boolean, required: True for the shared system catalog, False for a font you uploaded
    - `preview_url` string, nullable: Legacy rendered preview image, when available; new catalog entries no longer include one (use file_url for live previews)
    - `file_url` string, nullable: URL of the web-optimized WOFF2 file for live @font-face preview: a public CDN URL for system fonts, a short-lived link for your own uploads. Null for premium fonts; the original TTF/OTF source is never exposed.
    - `created_at` string, nullable: When the font was added
  - `pagination` FontPagination, required: Pagination envelope for the font list.
    - `page` integer, required: Current page (1-based)
    - `per_page` integer, required: Results per page
    - `total` integer, required: Total fonts matching the query

---

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