---
title: "Retrieve an existing image profile."
method: GET
path: "/authoring/v1/image-profiles/{id}"
tags: ["Authoring image profiles"]
---

# Retrieve an existing image profile.

`GET /authoring/v1/image-profiles/{id}`

Use the /image-profiles/{id} end-point to retrieve an existing image profile from the database.<br />User roles: admin, manager, editor, viewer

## Path parameters

- `id` string, required

## Query parameters

- `fields` string
- `include` string

## Headers

- `If-None-Match` string

## Response `200`

Success.

- object — An existing image profile.
  - `id` string — The ID of the image profile.
  - `rev` string, required — The current revision of the image profile.
  - `name` string, required — The name of the image profile.
  - `description` string — The description of the image profile.
  - `classification` 'image-profile', required
  - `creatorId` string, required — The ID of the user that created the image profile.
  - `creator` string — The display name of the user that created the image profile. This field is only returned when the 'include' query string option is set to 'ALL' or 'metadata'. This field is read only.
  - `created` string, date-time — The created date of this image profile in ISO 8601 with the format YYYY-MM-DDThh:mm:ss.sssZ. This field is read only.
  - `lastModifierId` string — The ID of the user that last modified the image profile.
  - `lastModifier` string — The display name of the last user that modified the image profile. This field is only returned when the 'include' query string option is set to 'ALL' or 'metadata'. This field is read only.
  - `lastModified` string, date-time — The last modified date of this image profile in ISO 8601 with the format YYYY-MM-DDThh:mm:ss.sssZ. This field is read only.
  - `tags` string[]
  - `dimensions` object[], required
    - `label` string — The dimension label.
    - `key` string — The dimension key.
    - `description` string — The description of the dimension.
    - `width` number — The dimension's width
    - `height` number — The dimension's height
  - `isSystem` boolean — Indicates whether this item is a 'system item' or not.

## Other responses

- `304` — Not modified is returned when using If-None-Match header and the value matches the latest version of the item.
- `404` — The document with ID {id} was not found OR Current tenant's database is not provisioned.
- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/revisions/677305266d89/schema)