List available fonts

GET/fonts

Sample request

cURL

curl -X GET "https://api.abyssale.com/fonts" \
  -H "x-api-key: $ABYSSALE_API_KEY"

Node.js

import abyssale from '@abyssale/sdk';

const { data, error } = await abyssale.listFonts();

if (error) console.error(error.id, error.message);
else console.log(data);

Python

from abyssale import Abyssale

with Abyssale() as client:
    result = client.list_fonts()

print(result)

Example 200 response

[
  {
    "id": "61568e7c-33c5-11ea-9877-92672c1b8195",
    "name": "Ubuntu Mono",
    "available_weights": [
      100
    ],
    "type": "google"
  }
]

Example 401 error response

{
  "message": "Unauthorized: missing or invalid API key.",
  "id": "unauthorized"
}

Retrieve all fonts available in your Abyssale workspace, including Google Fonts and any custom fonts you have uploaded. Use a font's id to override the font on text or button elements in a generation request.

Query parameters

type string

Filter fonts by type. Omit to return both Google and custom fonts. An unknown value is ignored and the full unfiltered list is returned — this never answers 400 (long-standing behavior existing integrations rely on). One of "google", "custom".

Response 200

The fonts available to this workspace.

Errors

Every failure uses the shared error envelope — {id, message, errors?}. Branch on id, never on message. See Errors.

Status	When
401	Unauthorized — missing or invalid API key.
429	Too Many Requests.
500	Internal Server Error — an unexpected error occurred on our side.

Related

• Fonts guide