Endpoint:
GET https://api.mailjet.com/v1/REST/images/:id
Retrieve metadata for a single image using its unique ID, including details such as the status, name, and label IDs.
URL Parameters
id: The ID of the image.
curl --request GET \
--url https://api.mailjet.com/v1/rest/images/a3da1de2-2319-44e9-9c75-e6a00a2ec5da \
--header 'Authorization: Bearer 612d5125131d406081abb9cd2afdc4e3'Status code: 200
| Name | Type | Description |
|---|---|---|
ID | string | The ID of the image. |
Name | string | The name of the image. |
Status | string | Indicates whether the image is open or locked. |
TargetContent | string | Indicates the purpose of the image. Possible values: image, background, video or social. |
ImageSize | integer | The size of the image file in bytes. |
LabelIDs | array of integers | An array of IDs representing labels associated with the image. |
IsStarred | boolean | Indicates whether the image is marked as a favorite. |
ImageURL | string | The URL where the image is stored. |
ThumbnailUrl | string | The URL where the thumbnail is stored. |
CreatedAt | DateTime UTC | The date and time when the image was created. |
UpdatedAt | DateTime UTC | The date and time when the image was last updated. |
ExpiresAt | DateTime UTC | The date and time when the image will expire. |
{
"Count": 1,
"Total": 1,
"Data": [
{
"ID": "a3da1de2-2319-44e9-9c75-e6a00a2ec5da",
"OrganisationID": 2,
"Name": "My Image",
"Status": "open",
"TargetContent": "image",
"ImageSize": 425155,
"ThumbnailSize": 425155,
"TotalSize": 850310,
"LabelIDs": [],
"IsStarred": false,
"ImageUrl": "https://0abcd.mjt.lu/img2/0abcd/a3da1de2-2319-44e9-9c75-e6a00a2ec5da/content",
"ThumbnailUrl": "https://0abcd.mjt.lu/img2/0abcd/a3da1de2-2319-44e9-9c75-e6a00a2ec5da/thumbnail",
"CreatedAt": "2024-05-23T12:51:58.97041Z",
"UpdatedAt": "2024-05-23T13:17:52.522524Z",
"ExpiresAt": "2024-12-10T00:00:00Z"
}
]
}