--- title: List Fonts | Luma Agents --- GET /v1/fonts Select code samplecURL (shell:curl) ```js const url = 'https://agents.lumalabs.ai/v1/fonts'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```sh curl --request GET \ --url https://agents.lumalabs.ai/v1/fonts \ --header 'Authorization: Bearer ' ``` - Productionagents.lumalabs.ai/v1/fonts Every family with at least one ready face, alphabetical. ## Authorizations - **[BearerAuth](/api/agents/index.md#bearerauth)** ## Parameters ### Query Parameters **scope\_id** Any of: - [string](#tab-panel-0-0) - [null](#tab-panel-0-1) string null List what this workspace sees — its own families plus the client tier's; omit for the client tier. ## Responses ### 200 Successful Response Media typeapplication/json *ClientFontList* object **data** required *Data* Array\ *ClientFontFamily* One font family and its ready faces. object **faces** required *Faces* Array\ *ClientFontFace* One ready face, with a presigned download URL. object **id** required *Id* A `font_face:` ref. string **is\_variable** *Is Variable* boolean **line\_height\_ratio** Any of: - [number](#tab-panel-1-0) - [null](#tab-panel-1-1) number null **name** required *Name* string **style** required *Style* string **url** required *Url* string **variation\_axes** Any of: - [Array\](#tab-panel-2-0) - [null](#tab-panel-2-1) Array\ *FontAxisOut* One OpenType variation axis from an uploaded variable font. object **default\_value** required *Default Value* number **max\_value** required *Max Value* number **min\_value** required *Min Value* number **tag** required *Tag* string null **weight** required *Weight* integer **id** required *Id* A `font_family:` ref. string **name** required *Name* string **normalized\_family\_name** required *Normalized Family Name* string **preview\_face** required *ClientFontFace* One ready face, with a presigned download URL. object **id** required *Id* A `font_face:` ref. string **is\_variable** *Is Variable* boolean **line\_height\_ratio** Any of: - [number](#tab-panel-3-0) - [null](#tab-panel-3-1) number null **name** required *Name* string **style** required *Style* string **url** required *Url* string **variation\_axes** Any of: - [Array\](#tab-panel-4-0) - [null](#tab-panel-4-1) Array\ *FontAxisOut* One OpenType variation axis from an uploaded variable font. object **default\_value** required *Default Value* number **max\_value** required *Max Value* number **min\_value** required *Min Value* number **tag** required *Tag* string null **weight** required *Weight* integer **scope\_id** required Any of: - [string](#tab-panel-5-0) - [null](#tab-panel-5-1) string format: uuid null ##### Example ```json { "data": [ { "faces": [ { "is_variable": false } ], "preview_face": { "is_variable": false } } ] } ``` ### 422 Validation Error Media typeapplication/json *HTTPValidationError* object **detail** *Detail* Array\ *ValidationError* object **ctx** *Context* object **input** *Input* **loc** required *Location* Array **msg** required *Message* string **type** required *Error Type* string ##### Examplegenerated ```json { "detail": [ { "ctx": {}, "input": "example", "loc": [ "example" ], "msg": "example", "type": "example" } ] } ```