---
title: "Get image details"
method: GET
path: "/v1/images/{id}"
tags: ["Images"]
---

# Get image details

`GET /v1/images/{id}`

## Request

- Base URL: `https://api.pixelvault.dev`
- URL: `https://api.pixelvault.dev/v1/images/{id}`
- Auth: HTTP bearer

Retrieve metadata and CDN URL for a specific image.

## Path parameters

- `id` string, required

## Response `200`

Image details

- object
  - `data` Image
    - `id` string
    - `url` string, uri: CDN URL. Supports on-the-fly transforms via query params: size (s|m|l|social), w, h (px, snapped to a discrete set), fit (scale-down|contain|cover|crop|pad), fmt (auto|webp|avif|jpg|png), q (auto|60|75|85), segment (foreground — AI background removal, transparent PNG), background (fill: hex, rgb()/rgba(), or a common CSS color name), gravity (auto|face|left|right|top|bottom|XxY, with fit=cover|crop), zoom (0.0-1.0, with gravity=face), blur (0-250), sharpen (0-10), rotate (90|180|270), flip (h|v|hv), brightness/contrast (multiplier, 1=no change), saturation (multiplier, 0=grayscale), tile (watermark: tile another of your project's images over the base). See the serve_image operation for the full parameter reference. Example: ?w=800&blur=30&saturation=0
    - `mime_type` string
    - `size` integer
    - `width` integer, nullable
    - `height` integer, nullable
    - `filename` string
    - `folder` string, nullable
    - `created_at` string, date-time

## Other responses

- `401`: Invalid or missing API key
- `404`: Image not found

---

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