---
title: "Get file styles"
method: GET
path: "/v1/files/{file_key}/styles"
tags: ["Styles"]
---

# Get file styles

`GET /v1/files/{file_key}/styles`

Get a list of published styles within a file library.

## Path parameters

- `file_key` string, required

## Response `200`

Response from the GET /v1/files/{file_key}/styles endpoint.

- object
  - `status` 200, required — The status of the request.
  - `error` false, required — For successful requests, this value is always `false`.
  - `meta` object, required
    - `styles` PublishedStyle[], required
      - `key` string, required — The unique identifier for the style
      - `file_key` string, required — The unique identifier of the Figma file that contains the style.
      - `node_id` string, required — ID of the style node within the figma file
      - `style_type` 'FILL' | 'TEXT' | 'EFFECT' | 'GRID', required — The type of style
      - `thumbnail_url` string — A URL to a thumbnail image of the style.
      - `name` string, required — The name of the style.
      - `description` string, required — The description of the style as entered by the publisher.
      - `created_at` string, date-time, required — The UTC ISO 8601 time when the style was created.
      - `updated_at` string, date-time, required — The UTC ISO 8601 time when the style was last updated.
      - `user` User, required — A description of a user.
        - `id` string, required — Unique stable id of the user.
        - `handle` string, required — Name of the user.
        - `img_url` string, required — URL link to the user's profile image.
      - `sort_position` string, required — A user specified order number by which the style can be sorted.

## Other responses

- `400` — Bad request. Parameters are invalid or malformed. Please check the input formats. This error can also happen if the requested resources are too large to complete the request, which results in a timeout. Please reduce the number and size of objects requested.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort.
- `404` — The requested file or resource was not found.
- `429` — In some cases API requests may be throttled or rate limited. Please wait a while before attempting the request again (typically a minute).
- `500` — An internal server error occurred.

---

[API](https://skmtc.dev/thirdstrandstudio/apis/figma-api.md) · [All operations](https://skmtc.dev/thirdstrandstudio/apis/figma-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thirdstrandstudio/figma-api/revisions/48f84f49653a/schema)