Image Emotion API

Get Image Details

Retrieve all details for a specific image directly from the database.

Returns a complete standardized response with all possible fields. Fields that don't exist in the database are returned as null.

Access Control:

  • Authenticated users can access their own images
  • Admins can access all images
  • Sample images and shared images are publicly accessible
get/v2/images/{image_id}

Path parameters

image_idstring required

The unique ID of the image.

The unique ID of the image.

Response

Successful Response

actorsobject[] nullable

List of actors/known faces with image, name, and user_id

annotated_imagestring nullable

Annotated image URL

bulk_upload_idstring nullable

Bulk upload batch ID

created_atstring nullable

Creation timestamp

csv_analysis_urlstring nullable

CSV analysis file URL

csv_statusstring nullable

CSV generation status

descriptionstring nullable

Image description

face_detection_statusstring nullable

Face detection status message

facesobject[] nullable

Detected faces with emotions

found_facesinteger[] nullable

List of found face IDs

heightnumber nullable

Image height in pixels

idstring nullable

Unique image identifier

is_userboolean nullable

Whether this is a user-uploaded image

model_idstring nullable

Model used for processing

notesstring nullable

General notes for the image

original_frame_imagestring nullable

Original image URL

predefined_qaobject[] nullable

Predefined Q&A about the image

psychologist_reviewstring nullable

Psychologist review content

psychologist_review_statusstring nullable

Psychologist review status

share_statusboolean nullable

Whether image is shared

statusstring nullable

Processing status

tags_mapobject nullable

Tags map with general and sample flags

thumbnailstring nullable

Thumbnail image URL

titlestring nullable

Image title

ui_requestboolean nullable

Whether request came from UI

user_idstring nullable

Owner user ID

widthnumber nullable

Image width in pixels