---
title: "Download an icon"
method: GET
path: "/v1/icons/{id}/download"
tags: ["Icons"]
---

# Download an icon

`GET /v1/icons/{id}/download`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/icons/{id}/download`
- Auth: API key in header `x-magnific-api-key`

Download the specified icon by its unique ID in the requested format and size.

## Path parameters

- `id` integer, required

## Query parameters

- `format` 'svg' | 'png' | 'gif' | 'mp4' | 'aep' | 'json' | 'psd' | 'eps'
- `png_size` 512 | 256 | 128 | 64 | 32 | 24 | 16

## Headers

- `Accept-Language` string

## Response `200`

OK

- DataIconDownload
  - `data` DataIconDownloadData
    - `filename` string
    - `url` string, uri

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `403`: Forbidden - The client does not have permission to access the requested resource.
- `404`: Not Found - The server can not find the requested resource.
- `429`: Too Many Requests - The client has sent too many requests in a given amount of time.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)