Fonts

Every account renders from the built-in catalogue: the full open-licensed Google Fonts library, 2,000+ families under the OFL, Apache and UFL licences, free to use in commercial work. Pro and Scale plans can also upload their own TTF and OTF files.

Browse the catalogue

const response = await fetch("https://api.sudomock.com/api/v1/fonts?search=Open&per_page=50", {
  method: "GET",
  headers: { "x-api-key": "sm_your_api_key" },
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init("https://api.sudomock.com/api/v1/fonts?search=Open&per_page=50");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: sm_your_api_key",
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

response = requests.get(
    "https://api.sudomock.com/api/v1/fonts?search=Open&per_page=50",
    headers={"x-api-key": "sm_your_api_key"},
)

response.raise_for_status()
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.sudomock.com/api/v1/fonts?search=Open&per_page=50")
request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "sm_your_api_key"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.sudomock.com/api/v1/fonts?search=Open&per_page=50", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", "sm_your_api_key")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sudomock.com/api/v1/fonts?search=Open&per_page=50"))
    .header("x-api-key", "sm_your_api_key")
    .GET()
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

using System.Net.Http;
using System.Text;

var request = new HttpRequestMessage(HttpMethod.Get, "https://api.sudomock.com/api/v1/fonts?search=Open&per_page=50");
request.Headers.Add("x-api-key", "sm_your_api_key");

var client = new HttpClient();
var response = await client.SendAsync(request);

Console.WriteLine(await response.Content.ReadAsStringAsync());

curl -X GET "https://api.sudomock.com/api/v1/fonts?search=Open&per_page=50" \
  -H "x-api-key: sm_your_api_key"

search matches family names without regard to case, category takes an exact value such as serif or sans-serif, and scope narrows the result to system for the catalogue alone or custom for your own uploads. page and per_page page through the result, up to 100 per page.

{
  "success": true,
  "data": [
    {
      "uuid": "9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
      "family": "Open Sans",
      "subfamily": "Regular",
      "postscript_name": "OpenSans-Regular",
      "category": "sans-serif",
      "license": "OFL",
      "is_system": true,
      "created_at": "2026-07-13T00:00:00Z"
    }
  ],
  "pagination": { "page": 1, "per_page": 50, "total": 1 }
}

Keep uuid or postscript_name: either one addresses the font in a render.

Use a font in a render

Set font on a text layer override.

{
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
  "text_layers": [
    {
      "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
      "text": "SUMMER SALE",
      "font": "OpenSans-Bold",
      "font_size": 96
    }
  ]
}

Omit font and the layer renders in the typeface the designer chose. Send it and the render uses yours, at the size and colour you set alongside it. See Text layers for the rest of the override. A uuid is the exact address, while a PostScript name is the readable one. Prefer the uuid when a name could match more than one font available to you: an ambiguous name returns 422 FONT_AMBIGUOUS with a candidates list rather than choosing for you.

Upload your own font

POST /api/v1/fonts takes one TTF or OTF file, up to 5 MB, on Pro and Scale plans. Pro includes 10 custom fonts and Scale is unlimited. Free and Starter plans render from the catalogue.

curl -X POST "https://api.sudomock.com/api/v1/fonts" \
  -H "x-api-key: sm_your_api_key" \
  -F "file=@MyBrand-Bold.ttf" \
  -F "license_confirmed=true"

A public URL works in place of a file upload.

const response = await fetch("https://api.sudomock.com/api/v1/fonts", {
  method: "POST",
  headers: {
    "x-api-key": "sm_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "url": "https://your-domain.com/fonts/MyBrand-Bold.ttf",
    "license_confirmed": true
  }),
});

const data = await response.json();
console.log(data);

<?php

$payload = <<<'JSON'
{
  "url": "https://your-domain.com/fonts/MyBrand-Bold.ttf",
  "license_confirmed": true
}
JSON;

$ch = curl_init("https://api.sudomock.com/api/v1/fonts");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: sm_your_api_key",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

payload = {
    "url": "https://your-domain.com/fonts/MyBrand-Bold.ttf",
    "license_confirmed": true
}

response = requests.post(
    "https://api.sudomock.com/api/v1/fonts",
    headers={"x-api-key": "sm_your_api_key"},
    json=payload,
)

response.raise_for_status()
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.sudomock.com/api/v1/fonts")
request = Net::HTTP::Post.new(uri)
request["x-api-key"] = "sm_your_api_key"
request["Content-Type"] = "application/json"

request.body = <<~JSON
  {
    "url": "https://your-domain.com/fonts/MyBrand-Bold.ttf",
    "license_confirmed": true
  }
JSON

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{
  "url": "https://your-domain.com/fonts/MyBrand-Bold.ttf",
  "license_confirmed": true
}`)

	req, err := http.NewRequest("POST", "https://api.sudomock.com/api/v1/fonts", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", "sm_your_api_key")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String payload = """
{
  "url": "https://your-domain.com/fonts/MyBrand-Bold.ttf",
  "license_confirmed": true
}
""";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sudomock.com/api/v1/fonts"))
    .header("x-api-key", "sm_your_api_key")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(payload))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

using System.Net.Http;
using System.Text;

var payload = """
{
  "url": "https://your-domain.com/fonts/MyBrand-Bold.ttf",
  "license_confirmed": true
}
""";

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.sudomock.com/api/v1/fonts");
request.Headers.Add("x-api-key", "sm_your_api_key");
request.Content = new StringContent(payload, Encoding.UTF8, "application/json");

var client = new HttpClient();
var response = await client.SendAsync(request);

Console.WriteLine(await response.Content.ReadAsStringAsync());

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

Both forms require license_confirmed: true, confirming you hold the right to use and embed the font. Without it the upload returns 422 with Confirm you have the right to use and embed this font. The 201 response carries the font’s uuid and postscript_name, which is what you send in a render from then on.

{
  "uuid": "72da2104-70f3-41ff-a4bc-68f51d873bfd",
  "family": "My Brand",
  "subfamily": "Bold",
  "postscript_name": "MyBrand-Bold",
  "is_system": false,
  "created_at": "2026-07-24T10:00:00Z"
}

Upload each weight you intend to render as its own file. A brand family with Regular, Medium and Bold is three uploads and three PostScript names.

Get or delete a font

GET /api/v1/fonts/{uuid} returns a catalogue font or one of your own. DELETE /api/v1/fonts/{uuid} removes one of your uploads and returns { "success": true }. Catalogue fonts are read-only and cannot be deleted. Deleting a custom font is permanent, so update any template or stored request that names its uuid first.

When a font is missing

If you send no replacement font, the layer renders in its original typeface where that is available. If an original or resolved catalogue font file cannot be loaded at render time, the render still succeeds in a default font and returns a TEXT_FONT_FALLBACK warning.

{
  "success": true,
  "data": { "print_files": [] },
  "warnings": [
    {
      "code": "TEXT_FONT_FALLBACK",
      "message": "Original font not in catalog; rendered in a default font."
    }
  ]
}

A font you explicitly requested behaves differently: it does not fall back. An unavailable name returns 422 FONT_NOT_FOUND, so an exact brand typeface can never be silently swapped for something else. Check font_available on each text layer in the upload response and you know which templates will fall back before you render one.

missing = [
    layer["name"]
    for layer in mockup["text_layers"]
    if layer["font_available"] is False
]

if missing:
    print("Upload these fonts, or set font explicitly:", missing)

A font that is present but lacks some characters in your replacement text returns TEXT_FONT_MISSING_GLYPHS, so the fix is to pick a family that covers the script you are rendering.

Text layers

Address a layer, override its wording, and read the support matrix.

Fonts reference

Every parameter and response field on the fonts endpoints.

Overview

PSD mockups

Photo mockups

Text and fonts

Integrations

Reference

Advanced

Changes

Browse the catalogue

Use a font in a render

Upload your own font

Get or delete a font

When a font is missing

Text layers

Fonts reference

​Browse the catalogue

​Use a font in a render

​Upload your own font

​Get or delete a font

​When a font is missing

Text layers

Fonts reference

Browse the catalogue

Use a font in a render

Upload your own font

Get or delete a font

When a font is missing