List vision images

POST

/v2/project/content/vision/listImages

List this project's submitted images, newest first, with the enriched image object for every image that is complete.

Analysis runs asynchronously, so an image listed as pending is still being worked on. An empty body {} returns the first page of everything this project has submitted.

Limit defaults to 50, caps at 100; Offset defaults to 0.

Status filters to pending, completed or failed; any other value returns 400.

Ordered by SubmittedAt then ImageID, both descending.

Data is the array itself; Pagination.Total counts the match.

A Status filter covers your newest 10,000 submissions.

404 means Vision AI is not enabled for your project.

429 means the rate limit was hit; wait Retry-After seconds.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

One page of this project's submitted images, newest first.

Headers

Bodyapplication/json

🟠400listVisionImages_BadRequest

🟠401listVisionImages_Unauthorized

🟠403listVisionImages_Forbidden

🟠404listVisionImages_NotFound

🟠429listVisionImages_TooManyRequests

🔴500listVisionImages_InternalServerError

Request Example

Shell

JavaScript

Java

Swift

cURL

First page of everything this project has submittedOnly the analyzed images, two per pageAn offset beyond the last entry

curl --location 'https://api.ygo.ai/v2/project/content/vision/listImages' \
--header 'X-Project-ID: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'

Response Example

200 - Four images: one still being analyzed, two analyzed, one unreachable — three submitted without a hot

{
    "Data": [
        {
            "ImageID": "0199b2d0-11a5-7c5e-8f21-6d0e4f88b521",
            "URL": "https://ucarecdn.com/9c1b7e42-5a6d-4f38-9a11-2b7c8d5e6f01/",
            "Status": "pending",
            "SubmittedAt": "2026-09-09T16:04:51.812433Z",
            "BatchID": "0199b2d0-11a4-7c5e-8f21-5c9d3e77a410",
            "HotelID": "01a086e1-ffaf-7040-b032-76677278f0ae",
            "HotelName": "Vision AI API placeholder",
            "IsPlaceholderHotel": true
        },
        {
            "ImageID": "0199b2c4-8e31-77aa-9c02-3f5b71a2d9e4",
            "URL": "https://ucarecdn.com/3f0a1d55-8b2c-4e79-9d64-7a1c2b3d4e5f/",
            "Status": "completed",
            "SubmittedAt": "2026-09-09T16:04:12.550118Z",
            "BatchID": "0199b2c4-8e30-7b19-9a4d-2e7f6c1b8d33",
            "HotelID": "01a086e1-ffaf-7040-b032-76677278f0ae",
            "HotelName": "Vision AI API placeholder",
            "IsPlaceholderHotel": true,
            "Image": {
                "ID": "0199b2c4-8e31-77aa-9c02-3f5b71a2d9e4",
                "URL": "https://ucarecdn.com/3f0a1d55-8b2c-4e79-9d64-7a1c2b3d4e5f/",
                "Source": "photo",
                "Category": "restaurant",
                "Features": [
                    "indoor_seating",
                    "buffet"
                ],
                "Mood": [
                    "warm",
                    "inviting"
                ],
                "Tags": [
                    "breakfast"
                ],
                "AppealScore": 74,
                "QualityScore": 81,
                "Width": 2000,
                "Height": 1333,
                "Format": "jpeg",
                "FileSize": 611000,
                "DominantColor": "#8A6A48",
                "BlurHash": "L6PZfSjE.AyE_3t7t7R**0o#DgR4",
                "FileMetadata": {
                    "CaptureDate": "2012-06-14",
                    "Copyright": "© 2012 Hotel Sol S.A."
                },
                "Descriptions": {
                    "en-US": "Restaurant with buffet counters and set tables.",
                    "de-DE": "Restaurant mit Buffettheken und eingedeckten Tischen."
                },
                "Compliance": {
                    "AIGenerated": true
                },
                "FeatureDetections": [
                    {
                        "Label": "buffet",
                        "Confidence": 0.91
                    },
                    {
                        "Label": "indoor_seating",
                        "Confidence": 0.86
                    }
                ]
            }
        },
        {
            "ImageID": "0199b2c4-8e31-77aa-9c02-1a4c60b8c7f1",
            "URL": "https://ucarecdn.com/7d4e9b21-6c3a-4f52-8e10-9b8a7c6d5e4f/",
            "Status": "failed",
            "SubmittedAt": "2026-09-09T16:04:12.550118Z",
            "BatchID": "0199b2c4-8e30-7b19-9a4d-2e7f6c1b8d33",
            "HotelID": "01a086e1-ffaf-7040-b032-76677278f0ae",
            "HotelName": "Vision AI API placeholder",
            "IsPlaceholderHotel": true
        },
        {
            "ImageID": "0199a51f-4c23-7de8-b3a9-1122334455aa",
            "URL": "https://images.example-client.com/1234567/room-dbl-sea-1.jpg",
            "Status": "completed",
            "SubmittedAt": "2026-09-08T09:12:44.301882Z",
            "BatchID": "0199a51f-4c22-7de8-b3a9-0f1e2d3c4b5a",
            "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
            "HotelName": "Hotel Bahia Azul",
            "RoomRef": "DBL-SEA",
            "Image": {
                "ID": "0199a51f-4c23-7de8-b3a9-1122334455aa",
                "URL": "https://images.example-client.com/1234567/room-dbl-sea-1.jpg",
                "Source": "photo",
                "Category": "room",
                "Features": [
                    "sea_view",
                    "balcony",
                    "double_bed"
                ],
                "Mood": [
                    "bright",
                    "calm"
                ],
                "Tags": [
                    "sea_view"
                ],
                "AppealScore": 82,
                "QualityScore": 77,
                "Width": 1600,
                "Height": 1067,
                "Format": "jpeg",
                "FileSize": 412000,
                "DominantColor": "#2E6F95",
                "BlurHash": "LEHV6nWB2yk8pyo0adR*",
                "Descriptions": {
                    "en-US": "Double room with a balcony overlooking the sea.",
                    "de-DE": "Doppelzimmer mit Balkon und Meerblick."
                },
                "Compliance": {
                    "AIGenerated": true
                },
                "Presence": [
                    {
                        "Label": "adult",
                        "Confidence": 0.81
                    }
                ],
                "Safety": {
                    "Inappropriate": 0.02,
                    "OffTopic": null
                },
                "FeatureDetections": [
                    {
                        "Label": "sea_view",
                        "Confidence": 0.94
                    },
                    {
                        "Label": "balcony",
                        "Confidence": 0.88
                    }
                ]
            }
        }
    ],
    "Pagination": {
        "Total": 4,
        "Limit": 50,
        "Offset": 0
    }
}

Modified at 2026-09-14 07:24:05

Get vision images

GetEnrichedHotelRequest