IMimentiv
Image Emotion API

Get Image Details

Changed on

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}

Request

  • Base URL
    https://api.imentiv.ai (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer
    • or OAuth 2
      Authorization code: https://api.imentiv.ai/oauth/authorize
      Token URL: https://api.imentiv.ai/oauth/token scopes: media.read

Path parameters

image_idstring required

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

updated_atstring nullable

ISO-8601 UTC timestamp of the last change to this image. Compare it for inequality with the value you hold to tell whether your copy is stale; it carries no ordering guarantee. It covers this image's own fields only, not data derived from other records such as frames or analytics.

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

The user who created the item (the same value as created_by).

created_bystring nullable

The user who created the item. Never changes, including when the item is moved to a workspace.

widthnumber nullable

Image width in pixels

Example response

{
  "updated_at": "2025-12-01T14:30:00.000000+00:00"
}

Changes

  • bd825cd86e8cRevision changes
    • info

      added the optional property to the response with the status

  • 45bdd041d683Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status