---
title: "Retrieve a single font"
method: GET
path: "/api/v1/fonts/{uuid}"
tags: ["Fonts"]
---

# Retrieve a single font

`GET /api/v1/fonts/{uuid}`

## Request

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

Fetch a single font by id: a system font, or one of your own uploads.

## Path parameters

- `uuid` string, required: Font id

## Response `200`

Successful Response

- FontResponse: A single font in the catalog: a shared system font, or one of the caller's own uploaded fonts.
  - `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

---

[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)