Get Fonts

Retrieve a list of available fonts, with optional filtering by classification, name, and source.

Endpoint

POST font/get

Authentication

Include your Enterprise API credentials in the request headers:

sivi-api-key: YOUR_API_KEY

Request Body Example

{
  "classification": ["sans-serif", "serif"],
  "name": "Roboto",
  "source": "system",
  "limit": 20,
  "cursor": null
}

Request Parameters

Parameter	Type	Required	Description
classification	Array	No	Filter by font classification. Allowed values: serif, sans-serif, display, handwriting, monospace
name	String	No	Filter fonts by name (partial match)
source	String	No	Filter by font source. Allowed values: system, user
limit	Number	No	Number of items to return (1-100)
cursor	String	No	Cursor for pagination
abstractUserId	String	No	Unique identifier for the user (Enterprise/Super API only)

Response

Success Response (200 OK)

{
  "status": 200,
  "body": {
    "data": [
      {
        "id": "f_abc123",
        "name": "Roboto",
        "classification": "sans-serif"
      }
    ],
    "meta": {
      "cursor": "691443e27209a0eab5771a1b"
    }
  }
}

Response Body Parameters

Parameter	Type	Description
data	Array	List of font objects
data[].id	String	Font identifier
data[].name	String	Font name
data[].classification	String	Font classification
meta.cursor	String	Cursor for fetching the next page of results

Error Responses

Authentication Error (401 Unauthorized)

{
  "status": 401,
  "body": {
    "message": "Failed to authenticate request. Please add sivi-api-key header in request"
  }
}

Invalid Input (422 Unprocessable Entity)

{
  "status": 422,
  "body": {
    "message": "Invalid input"
  }
}

Server Error (500 Internal Server Error)

{
  "status": 500,
  "body": {
    "message": "Failed to fetch fonts."
  }
}

Usage Notes

• Use classification to filter fonts by type (e.g., sans-serif for clean modern fonts, handwriting for script-style fonts)
• The source parameter distinguishes between built-in system fonts and user-uploaded custom fonts
• source: "system" returns Google Fonts available in Sivi (free, enabled fonts)
• source: "user" returns fonts uploaded by the authenticated user
• Results are paginated; use the returned cursor value in subsequent requests to fetch more results