--- title: "Get Image Details" method: GET path: "/v2/images/{image_id}" tags: ["Image Emotion API"] --- # Get Image Details `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) - URL: `https://api.imentiv.ai/v2/images/{image_id}` - Auth: one of: - API key in header `X-API-Key` - HTTP bearer - OAuth 2 - Authorization code: `https://api.imentiv.ai/oauth/authorize` - Token URL: `https://api.imentiv.ai/oauth/token` scopes: `media.read` 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 ## Path parameters - `image_id` string, required: The unique ID of the image. ## Response `200` Successful Response - ImageDetailResponseV2: Complete V2 response model for image details with all possible fields. Returns null for fields that don't exist in the database. Fields are ordered alphabetically. - `actors` object[], nullable: List of actors/known faces with image, name, and user_id - `annotated_image` string, nullable: Annotated image URL - `bulk_upload_id` string, nullable: Bulk upload batch ID - `created_at` string, nullable: Creation timestamp - `updated_at` string, 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_url` string, nullable: CSV analysis file URL - `csv_status` string, nullable: CSV generation status - `description` string, nullable: Image description - `face_detection_status` string, nullable: Face detection status message - `faces` object[], nullable: Detected faces with emotions - `found_faces` integer[], nullable: List of found face IDs - `height` number, nullable: Image height in pixels - `id` string, nullable: Unique image identifier - `is_user` boolean, nullable: Whether this is a user-uploaded image - `model_id` string, nullable: Model used for processing - `notes` string, nullable: General notes for the image - `original_frame_image` string, nullable: Original image URL - `predefined_qa` object[], nullable: Predefined Q&A about the image - `psychologist_review` string, nullable: Psychologist review content - `psychologist_review_status` string, nullable: Psychologist review status - `share_status` boolean, nullable: Whether image is shared - `status` string, nullable: Processing status - `tags` union[], nullable: Generalized media tags (demographic, survey, label, system). Discriminated union over value_type — see /v2/tag-keys for dimension metadata. - union - StringTag - `id` string, required - `key` string, required - `source` string, required - `created_at` string, date-time, required - `created_by` string, nullable - `value_type` 'string', required - `value_text` string, required - EnumTag - `id` string, required - `key` string, required - `source` string, required - `created_at` string, date-time, required - `created_by` string, nullable - `value_type` 'enum', required - `value_text` string, required - IntegerTag - `id` string, required - `key` string, required - `source` string, required - `created_at` string, date-time, required - `created_by` string, nullable - `value_type` 'integer', required - `value_int` integer, required - BoolTag - `id` string, required - `key` string, required - `source` string, required - `created_at` string, date-time, required - `created_by` string, nullable - `value_type` 'boolean', required - `value_bool` boolean, required - DateTag - `id` string, required - `key` string, required - `source` string, required - `created_at` string, date-time, required - `created_by` string, nullable - `value_type` 'date', required - `value_date` string, date-time, required - GeoTag - `id` string, required - `key` string, required - `source` string, required - `created_at` string, date-time, required - `created_by` string, nullable - `value_type` 'location_admin', required - `value_geo` GeoValue, required: Administrative-level location. lat/lng intentionally omitted in v1. - `country` string, nullable - `state` string, nullable - `city` string, nullable - SetTag - `id` string, required - `key` string, required - `source` string, required - `created_at` string, date-time, required - `created_by` string, nullable - `value_type` 'set', required - `value_text` string, required - NoneTag - `id` string, required - `key` string, required - `source` string, required - `created_at` string, date-time, required - `created_by` string, nullable - `value_type` 'none', required - `tags_map` object, nullable: Tags map with general and sample flags - `thumbnail` string, nullable: Thumbnail image URL - `title` string, nullable: Image title - `ui_request` boolean, nullable: Whether request came from UI - `user_id` string, nullable: The user who created the item (the same value as `created_by`). - `created_by` string, nullable: The user who created the item. Never changes, including when the item is moved to a workspace. - `owner` MediaOwnerOut: Who owns a media item. Never carries an email address. - `kind` 'user' | 'workspace', required: `user`: an item owned by one person, its creator. `workspace`: an item owned by a team workspace, which its members can read. This says who owns the item only; a share link or other access to it is separate. - `id` string, required: The owner's id: the user's id, or the workspace's id. - `name` string, nullable: The workspace's name, or the creator's display name. Absent when it is not known. - `width` number, nullable: Image width in pixels ## Other responses - `422`: Validation Error ## Changes - **2026-10-31** `bd825cd86e8c`: 1 info - added the optional property `updated_at` to the response with the `200` status - **2026-10-07** `45bdd041d683`: 2 info - added the optional property `created_by` to the response with the `200` status - added the optional property `owner` to the response with the `200` status - **2026-09-22** `536bf48bb9fb`: 3 info - the endpoint scheme security `ApiKeyAuth` was added to the API - the endpoint scheme security `BearerAuth` was added to the API - the endpoint scheme security `OAuth2Delegated` was added to the API - **2026-09-08** `b10651168511`: 1 info - added the optional property `tags` to the response with the `200` status - **2026-08-20** `74ceee4a5c98`: 1 info - endpoint added [Operation history](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/changes/v2/images/:image_id/get.md) --- [API](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai.md) - [All operations](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/revisions/bc15cec7e794?raw)