Skip to main content
GET
/
v1
/
font-generations
/
{jobId}
Get font generation status
const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.mixfont.com/v1/font-generations/{jobId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": "7d58a66d-f129-4f9a-bf9a-4f2c6d0c3e4d",
  "name": "Nebula Sans",
  "ttf_url": "https://static.mixfont.com/uploads/generated/7d58a66d-f129-4f9a-bf9a-4f2c6d0c3e4d/font.ttf",
  "status": "succeeded",
  "input_type": "text",
  "glyph_set": "standard",
  "progress_percent": 100,
  "created_at": "2026-06-02T21:12:42.000Z"
}
Fetch the current status of a font generation job. Poll this endpoint until status is succeeded, failed, or cancelled. When status is succeeded, ttf_url contains the generated TTF download URL.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
jobId
string
required

Generation id returned by the create endpoint.

Response

Current generation status

​
id
string
required

Generation id.

​
name
string
required

Generated font display name.

​
ttf_url
string<uri> | null
required

Download URL for the generated TTF file. This is null until the job succeeds.

​
status
enum<string>
required
Available options:
preparing,
queued,
running,
succeeded,
cancelled,
failed
​
input_type
enum<string>
required
Available options:
text,
image
​
glyph_set
enum<string>
default:standard
required

standard generates 72 glyphs to support English with basic letters, numbers, and punctuation. extended generates 319 glyphs to support all Latin languages, including special characters, costs more credits, and may take 2-3 minutes to complete.

Available options:
standard,
extended
​
progress_percent
number
required

Approximate job progress percentage.

Required range: 0 <= x <= 100
​
created_at
string<date-time>
required

ISO timestamp for when the generation was created.

​
error
string

Error message. Present only when status is failed and an error message is available.