Get Style

Returns metadata for a single published style, including its name, type, and description.

GET https://api.figma.com/v1/styles/:key

Authentication

Requires a valid access token with file_content:read scope. Pass via X-Figma-Token header (personal access token) or Authorization: Bearer header (OAuth).

Parameters

Path parameters

The unique style key. Retrieve style keys from the Get Styles endpoint.

Example Request

curl -X GET "https://api.figma.com/v1/styles/abc123" \
  -H "X-Figma-Token: YOUR_TOKEN"

Response

{
  "name": "Brand/Primary",
  "description": "Primary brand color",
  "style_type": "FILL",
  "key": "abc123",
  "file_key": "xyz789",
  "node_id": "1:100",
  "thumbnail_url": "https://s3-alpha.figma.com/checkpoints/...",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-20T14:00:00Z",
  "user": {
    "id": "12345",
    "handle": "designer"
  }
}

Response Fields

Field	Type	Description
`name`	`string`	Style name
`description`	`string`	Description set by the designer
`style_type`	`string`	One of: `FILL`, `TEXT`, `EFFECT`, `GRID`
`key`	`string`	The unique style key
`file_key`	`string`	The file key where this style is defined
`node_id`	`string`	The node ID of the style in the file
`thumbnail_url`	`string`	URL to a rendered thumbnail
`created_at`	`string`	ISO 8601 creation timestamp
`updated_at`	`string`	ISO 8601 last-modified timestamp
`user`	`object`	The user who last modified the style