Images

Get image

With this endpoint you can get a single image by ID.

Scopes: images.read

Rate Limiting: This endpoint is rate limited to 400 requests per minute.

get/images/{id}

Request

  • Base URL
    https://api.omnisend.com/api
  • URL
    https://api.omnisend.com/api/images/{id}
  • Auth
    • OAuth 2
      Client credentials
      Token URL: https://app.omnisend.com/oauth2/token scopes: images.read
    • or API key in header Authorization

Path parameters

idstring required

Image ID

Headers

Omnisend-Versionstring required

API version that specifies the response format and behaviour

Response

Image retrieved successfully

createdAtstring

Image creation timestamp.

heightinteger

Image height in pixels.

idstring

Unique image identifier.

namestring

Image name.

sizeinteger

Image size in bytes.

typestring

MIME type of the image.

urlstring

Public CDN URL of the image.

widthinteger

Image width in pixels.

Example response

{
  "createdAt": "2026-01-15T10:30:00Z",
  "height": 1080,
  "id": "507f1f77bcf86cd799439011",
  "name": "my-image",
  "size": 102400,
  "type": "image/jpeg",
  "url": "https://cdn.example.com/image.jpg",
  "width": 1920
}

Changes

No recorded changes to this operation across all 1 revision of this API.