---
title: "Get uploaded file metadata"
method: GET
path: "/v1/files/{fileId}/metadata"
tags: ["File Metadata"]
---

# Get uploaded file metadata

`GET /v1/files/{fileId}/metadata`

You can programmatically get image EXIF, pHash, and other metadata for uploaded files in the ImageKit.io media library using this API.

You can also get the metadata in upload API response by passing `metadata` in `responseFields` parameter.

## Path parameters

- `fileId` string, required

## Response `200`

File metadata object.

- Metadata — JSON object containing metadata.
  - `height` integer — The height of the image or video in pixels.
  - `width` integer — The width of the image or video in pixels.
  - `size` integer — The file size in bytes.
  - `format` string — The format of the file (e.g., 'jpg', 'mp4').
  - `hasColorProfile` boolean — Indicates if the image has a color profile.
  - `quality` integer — The quality indicator of the image.
  - `density` integer — The density of the image in DPI.
  - `hasTransparency` boolean — Indicates if the image contains transparent areas.
  - `pHash` string — Perceptual hash of the image.
  - `bitRate` integer — The bit rate of the video in kbps (only for video).
  - `duration` integer — The duration of the video in seconds (only for video).
  - `audioCodec` string — The audio codec used in the video (only for video).
  - `videoCodec` string — The video codec used in the video (only for video).
  - `exif` object
    - `image` ExifImage — Object containing EXIF image information.
      - `Make` string
      - `Model` string
      - `ImageDescription` string
      - `Artist` string
      - `Copyright` string
      - `Orientation` integer
      - `XResolution` number
      - `YResolution` number
      - `ResolutionUnit` integer
      - `Software` string
      - `ModifyDate` string
      - `YCbCrPositioning` integer
      - `ExifOffset` integer
      - `GPSInfo` integer
    - `thumbnail` Thumbnail — Object containing Thumbnail information.
      - `Compression` integer
      - `XResolution` number
      - `YResolution` number
      - `ResolutionUnit` integer
      - `ThumbnailOffset` integer
      - `ThumbnailLength` integer
    - `exif` ExifDetails — Object containing Exif details.
      - `ExposureTime` number
      - `FNumber` number
      - `ExposureProgram` integer
      - `ISO` integer
      - `ExifVersion` string
      - `DateTimeOriginal` string
      - `CreateDate` string
      - `ShutterSpeedValue` number
      - `ApertureValue` number
      - `ExposureCompensation` number
      - `MeteringMode` integer
      - `Flash` integer
      - `BrightnessValue` number
      - `MaxApertureValue` number
      - `LightSource` integer
      - `FocalLength` number
      - `UserComment` string
      - `SensingMethod` integer
      - `SceneType` string
      - `FocalLengthIn35mmFormat` integer
      - `LensModel` string
      - `SubSecTime` string
      - `FlashpixVersion` string
      - `ColorSpace` integer
      - `ExifImageWidth` integer
      - `ExifImageHeight` integer
      - `InteropOffset` integer
      - `FocalPlaneXResolution` number
      - `FocalPlaneYResolution` number
      - `FocalPlaneResolutionUnit` integer
      - `CustomRendered` integer
      - `ExposureMode` integer
      - `WhiteBalance` integer
      - `SceneCaptureType` integer
    - `gps` Gps — Object containing GPS information.
      - `GPSVersionID` integer[]
      - `GPSLatitudeRef` string
      - `GPSLatitude` number[]
      - `GPSLongitudeRef` string
      - `GPSLongitude` number[]
      - `GPSAltitudeRef` integer
      - `GPSAltitude` number
      - `GPSTimeStamp` number[]
      - `GPSImgDirectionRef` string
      - `GPSImgDirection` number
      - `GPSDateStamp` string
    - `interoperability` Interoperability — JSON object.
      - `InteropIndex` string
      - `InteropVersion` string
    - `makernote` object

## Other responses

- `400` — Bad request.
- `401` — Unauthorized request.
- `403` — Forbidden.
- `404` — File not found.
- `429` — The request exceeded the rate limit. Contains headers indicating the limits and a message detailing the error.

## Changes

- **2026-05-28** `66c74def8906` — 5 breaking, 21 info
  - the `exif/exif/FocalLength` response's property type/format changed from `integer`/`` to `number`/`` for status `200`
  - the `exif/image/XResolution` response's property type/format changed from `integer`/`` to `number`/`` for status `200`
  - the `exif/image/YResolution` response's property type/format changed from `integer`/`` to `number`/`` for status `200`
  - the `exif/thumbnail/XResolution` response's property type/format changed from `integer`/`` to `number`/`` for status `200`
  - …22 more

[Change history](https://skmtc.dev/imagekit-developer/apis/imagekit-api/changes/v1/files/:fileId/metadata/get.md)

---

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