Get Image Fills

Get download URLs for every image used as an image fill in a file. This is useful for extracting and caching all image assets from a design.

GET https://api.figma.com/v1/files/:file_key/images

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 key of the file to retrieve image fills from.

Example Request

curl -X GET "https://api.figma.com/v1/files/YOUR_FILE_KEY/images" \
  -H "X-Figma-Token: YOUR_TOKEN"

Response

{
  "err": false,
  "images": {
    "0:1": "https://s3-alpha.figma.com/img/abc...",
    "2:3": "https://s3-alpha.figma.com/img/def..."
  }
}

Response Fields

Field	Type	Description
`err`	`boolean`	`false` on success
`images`	`object`	Map of image references to their download URLs

The keys in the images object are image references, not node IDs. To map them to specific nodes, use the imageRef property from the file tree returned by the Get File endpoint.