REST

Fonts API

Browse fonts available to text layers and manage your own TTF or OTF files for personalized PSD mockups.

Catalog access and custom upload

Every account can browse and render with the shared font catalog. Custom font upload is available on Pro and Scale plans. Confirm that you have the right to use and embed every font you upload.

Authentication

Send your SudoMock API key in the x-api-key header.

List Fonts

GET/api/v1/fontsFree

pageinteger= 1

One-based page number.

per_pageinteger= 50

Results per page, from 1 to 100.

categorystring

Optional exact category, such as serif or sans-serif.

searchstring

Optional case-insensitive family-name search.

scopeenum= all

all for catalog plus your fonts, system for catalog only, or custom for your uploads only.

List fonts

1curl "https://api.sudomock.com/api/v1/fonts?scope=all&search=Open&page=1&per_page=50" \
2  -H "x-api-key: sm_your_api_key"

Response 200 OK

1{
2  "success": true,
3  "data": [
4    {
5      "uuid": "9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
6      "family": "Open Sans",
7      "subfamily": "Regular",
8      "postscript_name": "OpenSans-Regular",
9      "category": "sans-serif",
10      "license": "OFL",
11      "is_premium": false,
12      "is_system": true,
13      "preview_url": null,
14      "file_url": "https://cdn.sudomock.com/fonts/9f1c2d3e.woff2",
15      "created_at": "2026-07-13T00:00:00Z"
16    }
17  ],
18  "pagination": {
19    "page": 1,
20    "per_page": 50,
21    "total": 1
22  }
23}

Upload a Custom Font

POST/api/v1/fontsFree

Upload one TTF or OTF file, up to 5 MB. Send either multipart form data with a file field or JSON with a public url. In both cases, set license_confirmed to true.

Upload a local font file

1curl -X POST "https://api.sudomock.com/api/v1/fonts" \
2  -H "x-api-key: sm_your_api_key" \
3  -F "[email protected]" \
4  -F "license_confirmed=true"

Upload a font from a URL

1curl -X POST "https://api.sudomock.com/api/v1/fonts" \
2  -H "Content-Type: application/json" \
3  -H "x-api-key: sm_your_api_key" \
4  -d '{
5    "url": "https://your-domain.com/fonts/MyBrand-Bold.ttf",
6    "license_confirmed": true
7  }'

201Created

Response 201 Created

1{
2  "uuid": "72da2104-70f3-41ff-a4bc-68f51d873bfd",
3  "family": "My Brand",
4  "subfamily": "Bold",
5  "postscript_name": "MyBrand-Bold",
6  "category": null,
7  "license": null,
8  "is_premium": false,
9  "is_system": false,
10  "preview_url": null,
11  "file_url": "https://cdn.sudomock.com/fonts/72da2104.woff2",
12  "created_at": "2026-07-24T10:00:00Z"
13}

Get or Delete a Font

Method and path	Behavior
GET /api/v1/fonts/{uuid}	Returns a catalog font or one of your custom fonts.
DELETE /api/v1/fonts/{uuid}	Deletes one of your custom fonts and returns { "success": true }. Catalog fonts are read-only.

Delete only fonts you uploaded

Catalog fonts cannot be deleted. Deleting a custom font is permanent, so update any workflow that references its UUID before removing it.

Use a Font in a Render

Reference the font by its uuid or postscript_name in a text-layer override. See the Text Layers guide for the complete render request.